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About This Guide 


This guide describes how to install, configure, and customize Novell® iPrint. It is intended for 
network administrators and is divided into the following sections: 


+ Chapter 1, “Overview,” on page 13 

+ Chapter 2, “Setting Up ¡Print on Your Server,” on page 19 

+ Chapter 3, “Setting Up ¡Print on Client Workstations,” on page 27 

+ Chapter 4, “Customizing iPrint,” on page 37 

+ Chapter 5, “Managing Your Print System,” on page 43 

+ Chapter 6, “Setting Up a Secure Printing Environment,” on page 71 

+ Appendix A, “Configuring the ¡Print HTML Interface,” on page 79 

+ Appendix B, “Understanding ¡Print and Novell Distributed Print Services,” on page 89 
+ Appendix C, “Planning the Migration to iPrint,” on page 103 

+ Appendix D, “Troubleshooting Your Print System,” on page 109 


Documentation Updates 


The latest version of this Novell iPrint Administration Guide for NetWare 6.5 is available on the 
Novell documentation Web site (http://www.novell.com/documentation/lg/nw65). 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions within a step and items 
in a cross-reference path. 


A trademark symbol e, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party 
trademark. 


When a single pathname can be written with a backslash for some platforms or a forward slash for 
other platforms, the pathname is presented with a backslash. Users of platforms that require a 
forward slash, such as UNIX*, should use forward slashes as required by your software. 
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Overview 


This section will help you understand the following: 
+ What Is iPrint? (page 13) 
+ ¡Print Component Overview (page 14) 
+ ¡Print Solutions (page 14) 
+ What's New (page 15) 


What Is ¡Print? 


iPrint lets mobile employees, business partners, and customers access printers from a variety of 
remote locations using existing Internet connections. Whether users are working in an office 
building, telecommuting from home, or attending a sales meeting in another country, ¡Print ensures 
that they can print documents quickly, easily, and reliably. 


Using a Web browser, users point to a Web page that displays the available printers. By clicking a 
printer, the ¡Print client is installed (if not installed previously), the printer’s driver is downloaded, 
and a printer is created in the user’s Printer folder, enabling the user to send documents to the 
printer from any application on the desktop. 


Using iPrint, mobile users no longer need to contact a busy network administrator to find out a 
printer’s name and context and the required printer driver. Instead, mobile users work within a Web 
browser to locate nearby printers and download and install the latest printer drivers. Companies 
can reduce communication costs by reducing the need to fax documents between offices. Instead, 
companies can use their existing Internet connections to print documents to remote printers. 


¡Print Uses Industry Standards 


¡Print uses the Internet Printing Protocol (IPP), an industry standard, to eliminate the complexities 
of printing over the Internet and to make location-based printing a reality. 


The benefits of IPP include the following: 
+ Uses the IP protocol 
+ Provides broad vendor support 
+ Works over local networks and the Internet 
¢ Provides for print data encryption (SSL, TLS) 


+ Provides a standard print protocol for all platforms (Windows*, Macintosh*, Linux*, UNIX*, 
etc.) 


For more information about IPP, see the documents available on the Printer Working Group (http:/ 
/www.pwg.org/ipp/index.html) Web site. 
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¡Print Benefits 


In addition to the benefits of IPP, Novell’s implementation of ¡Print adds the following value: 
¢ printer driver download and installation 
+ Location-based printing 
+ Browser-enabled print interface 
+ Customizable user interface 


+ Secure information transfer 


For secure printing needs, iPrint integrates with Novell® eDirectory™ to ensure that only 
authorized users can access the printer. Users are required to authenticate with their eDirectory 
username and password. Print data is also encrypted to ensure that sensitive print data is kept 
secure and unaltered. 


iPrint Component Overview 


Novell iPrint utilizes the NDPS® infrastructure. iPrint enhances the users’ experience by providing 
a Web view of their printing environment. In addition to NDPS, iPrint uses the following 
components: 


+ A print provider and a set of browser plug-ins. 
These are installed on a user’s workstation. The Novell Client™ is not required. 
+ Ippsrvr.nim. This runs on the NetWare® server. 


When an eDirectory Printer object is configured as an iPrint printer, the Print Manager 
automatically loads this NLM™ on the server, which generates a URL for the printer. 


+ A set of HTML pages. 


These are provided to install the iPrint client software and printers as well as to view and 
manage print jobs. These pages are customizable. For more information, see Chapter 4, 
“Customizing iPrint,” on page 37. 


After setting up iPrint for your network, it easily expands to support the following scenarios. 
iPrint Solutions 


Printing across the Internet 


John is an employee working at home who wants to send a document to a printer at his office. John 
does not want to dial into the company’s network, but he has access to the Internet. 


1. John points his Web browser to the company’s print URL, http://Printing. MyCompany.Com/ 
1pp. 


2. From the Web page, John selects the printer to install. The iPrint client is automatically 
downloaded and installed on his computer. The printer driver is also downloaded and the 
printer installed in his computer’s Printers folder. 


3. From any application on his home computer, John can now print to the company’s printer. 
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Printing While Mobile 


Gail is visiting her company’s branch office in Paris. She needs to print a handout for an upcoming 
meeting. Gail knows she can print to the branch office printer, even though she does not know the 
printer’s name, eDirectory context, make, model, or required printer driver. 


1. Gail connects her laptop to the company network, clicks the ¡Print link on the company’s 
intranet Web page, and then clicks a link for the branch office she is visiting. A map of the 
branch office and ¡Print printers displays. 


2. Gail locates the office she is using and clicks the icon for the printer just outside her office. 


3. The printer driver is downloaded and a printer is created in the her laptop’s Printer folder. She 
didn’t need to install the ¡Print client software again because she had used ¡Print previously at 
a different branch office. 


4. From her application, Gail prints her handouts for the upcoming meeting. 


Printing Instead of Faxing 


Dan has just returned to his hotel room in Chicago after visiting with some clients. While checking 
his e-mail, he is reminded that he needs to submit a report to his boss in the corporate office in New 
York. The report is due by 8 a.m. Although he could send the report by fax, he wants a high-quality 
printout in color and he does not want to incur long distance telephone charges. 


1. Dan uses his laptop to dial in to a local Internet Service Provider. 


2. Using his Web browser, Dan accesses the company”s intranet Web page. Using the ¡Print map 
pages, he locates an ¡Print color printer adjacent to his boss’ office. 


3. After downloading and installing the printer driver, Dan uses his application to send the report 
to the printer. 


4. Dan returns to the ¡Print Web page and clicks the printer again to display printer management 
options. He monitors the printer job list to see that his print job is completed. 


5. Dan sends an e-mail to his boss telling him that the report is available at the printer. 


What's New 


The following changes and enhancements were added to ¡Print for NetWare 6.5: 


¡Print Map Designer 
+ Multiselect printer icons and simultaneous property modifications. 
¢ Set printer driver default properties such as paper size, orientation, color, collate, etc. 


¢ Set an attribute on a printer so that after it is installed, the printer is removed from the 
workstation upon the next reboot. 


+ Obtain a list of printers from the Print Manager without having to authenticate. 


Novell iManager 


+ View and manage retained print jobs and remove or set holds on print jobs. See “Managing 
Print Jobs” on page 54. 


+ Added links to NetWare Remote Manager for Broker Health and Print Manager Health 
+ Added a tab for XP Driver support. 
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Move printer agents to a different Print Manager. See “Moving Printer Agents to Another 
Print Manager” on page 53. 


Load and unload the Print Manager and Broker from iManager. 


Complete printer control (startup/shutdown, pause/resume input and output, etc.). See 
“Managing Printer Agents” on page 54. 


Added a page to edit the Gateway load commands for a printer agent. See “Modifying the 
Printer’s Gateway Load Commands” on page 58 


iPrint Client 


+ 


Manage printers from the command line. See “Implementing iPrint Using DOS Commands” 
on page 31. 


Capture LPT ports and redirect print jobs to an iPrint printer using the icapture.exe command 
or LPT Port Redirector Windows utility. 


Install printers on a Windows NT/2000/XP workstation without having Power User or 
Administrator rights. See “Setting Up iPrint on Client Workstations” on page 27. 


Set a proxy server for iPrint. See “Using a Proxy Server” on page 30. 


Set up iPrint to run on terminal servers. See “Configure iPrint for Terminal Server Clients” on 
page 30. 


When an updated iPrint client is released, you can control how workstations are automatically 
updated. See “Updating the iPrint Client” on page 29. 


Create a printer pool. See “Setting Up Printer Pooling” on page 46. 


View auditing information on a per user or printer basis. See “Using Print Auditing” on 
page 47. 


Set a printer’s persistence so that printers are removed automatically. See “Setting Printer 
Persistence” on page 35. 


Integrated with the NetIdentity client. 


Redesigned default page. See http://server_IP_ address_or_dns_name/ipp. 


General iPrint Enhancements 


+ 


+ 


iPrint runs on the Apache Web Server. 


iPrint information and links available from the NetWare 6.5 Welcome page (http:// 
server_IP_address). 


You can bind to network interface cards other than the primary card for the Broker and Print 
Manager and their services. 


You can create an Installed Printer Name Profile to show a shorter installed printer name. See 
“Creating an Installed Printer Name Profile” on page 34. 


Display SNMP traps from the Novell Gateway using NetWare Remote Manager. 


A command line switch, /NOADVERT, has been added to the Broker to turn off SRS 
advertising. 


The Print Manager database does an automatic backup five minutes after the creation of a 
Printer Agent. 


A command line switch, /NOSRS, has been added to the Print Manager to turn off SRS 
advertising. 


Novell iPrint Administration Guide for NetWare 6.5 


What's Next 


You can shut down and restart a printer agent using the Print Manager Health Monitor in 
NetWare Remote Manager. 


You create reports about your print system using the Print Manager Health Monitor in 
NetWare Remote Manager. See “Using the Print Manager Health Monitor” on page 44. 


The Print Manager uses the servers IP address by default, if a DNS name is not assigned to 
the Print Manager using the /dnsname=DNS_name command line switch. 


You must authenticate before accessing the Print Manager Health Monitor. 
The Novell Gateway is the default gateway when creating a new Printer. 


You can load and unload the Broker or Print Manager from Novell iManager. 


Chapter 2, “Setting Up ¡Print on Your Server,” on page 19: Helps you install the server 
software and configure your print system. 


Chapter 3, “Setting Up iPrint on Client Workstations,” on page 27: Helps you deploy the 
iPrint client to workstations and explains the features of the client. 


Chapter 4, “Customizing iPrint,” on page 37: With your print system set up and the client 
distributed to the workstation, you can focus on how your users can access and install iPrint 
Printers. 
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Setting Up ¡Print on Your Server 


Complete the following tasks to create an ¡Print print system: 
1. Meet ¡Print system setup requirements. 
2. Install ¡Print (if not already installed). 
3. Setup DNS for the print manager. 
4. Configure 1Print. 


iPrint Setup Requirements 


Before you set up ¡Print printers, you should complete the following: 


O Start Novell® iManager: iManager provides browser-based management of Novell 
eDirectory™. The ¡Print plug-in for Novell ¡Manager works only with Internet Explorer 5.5 
with Service Pack 2 or later. For more information, see the Novell iManager 2.0.x 
Administration Guide. 


U Set up DNS: When you create an ¡Print printer, a URL is associated with the printer. If DNS 
is not set up for printing, the URL will contain the server’s IP address. 


For more information about DNS, see, “Setting Up DNS for the Print Manager” on page 21. 


U Create a Broker: A Broker provides three network support services: Service Registry 
Service, Event Notification Service, and Resource Management Service. The resource 
management service stores printer drivers that are automatically downloaded and installed on 
client workstations. 


For more information, see “Creating a Broker” on page 22. 


U Add Print Drivers: With the Broker running, you can add printer drivers to the Resource 
Management System. The printer drivers are downloaded and installed when a workstation 
installs an ¡Print printer. 


For more information, see “Add Printer Drivers” on page 23. 


Q) Install a Print Manager: A Print Manager communicates print job information between 
users and printers, while also providing print job management, security and spooling. 


For more information, see “Creating a Print Manager” on page 24. 


QO) Create Printer Objects: Printer objects represent the printer in eDirectory and are associated 
to a printer agent that combines the functions previously performed by a printer, print queue, 
print server, and spooler. 


For more information, see “Creating a Printer” on page 25. 


For information on Client requirements, see “Client Requirements” on page 27. 
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IMPORTANT: In NetWare® 6.5, ¡Print runs on Apache 2. By default, Apache has Access Logging turned on, 
which will log all printing-related access information. The Access Logging log file is stored on sys:. The 
resulting log file might cause you to run out of disk space, causing printing to stop. 


To avoid running out of disk space, periodically remove old log files from sys:\apache2\logs, specify a different 
volume for the log file, or disable Access Logging. For more information, see "Working with Server Logs”" in 
the Apache Web Server Administration Guide for NetWare 6.5 or the log directives on the Apache Web site 
(http://httpd.apache.org/docs/logs.html). 


Installing iPrint Software 


If iPrint was selected during the during the NetWare® 6.5 installation, the ¡Print software 
components were automatically installed on the server. If iPrint was not selected during the 
installation, you need to install the iPrint software. 


41 From the GUI screen on the server, click Novell > Install. 
2 (Conditional) If an entry does not exist, click Add. 
If an iPrint entry is listed, iPrint is already installed. 
3 Insert the NetWare 6.5 CD 2 (Products) CD into the drive. 
4 Browse to and select the postinst.ni file at the root of the CD. 


5 Follow the installation prompts to install iPrint. 


Upgrading to Novell iPrint 
+ “Upgrading Existing iPrint Systems to NetWare 6.5” on page 20 
+ “Upgrading from NDPS to iPrint” on page 20 
+ “Migrating from Print Queues” on page 20 


IMPORTANT: When upgrading a NetWare 5.1 or 6.0 server with the Novonyx Web Server installed to 
NetWare 6.5, the document root is not updated. The document root from the Novonyx Web Server is copied 
to Apache’s httpd.conf file, instead of the document root for the Apache Web server. If iPrint does not work, 
edit the Apache configuration file (sys:\apache2\conf\httpd.conf) and change the DocumentRoot to the Apache 
document root (sys:\apache2\htdocs). You might need to change other entries in the .conf file. 


Upgrading Existing iPrint Systems to NetWare 6.5 


To upgrade a NetWare 5.1 or NetWare 6 server running iPrint, choose your upgrade method and 
run the upgrade. For more information on upgrading, see the NetWare 6.5 Overview and 
Installation Guide. 

Upgrading from NDPS to iPrint 


To upgrade from Novell Distributed Print Services® (NDPS®) 2.0 or Enterprise NDPS, choose 
your upgrade method and run the upgrade. For more information on upgrading, see the NetWare 
6.5 Overview and Installation Guide. 


After your server is upgraded to NetWare 6.5, enable iPrint for your printers. 


Migrating from Print Queues 


You can make the transition gradually from queues to Novell iPrint. If your users are running the 
Novell Client™ with the NDPS component installed, you can first replace the server components 
of your legacy printing system with the iPrint server components. Because the Print Manager 
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(ndpsm.nIm) and the Print Server (pserver.nlm) can run simultaneously on a server, this transition 
can be accomplished one queue/printer at a time. Users can then be gradually switched to print 
directly to ¡Print printers instead of queues. 


If your users do not have the NDPS component installed —later versions of the Novell Client did 
not install the NDPS component by default—then skip task 6 below. After creating your ¡Print 
system, have your users remove their old printers and install the ¡Print client and printers. 


Complete the following tasks to migrate from print queues: 
1. Understand the migration guidelines. 

. Setup DNS. 

. Create a Broker. 

. Create a Print Manager. 

. Create a Printer Agent. 

. Associate a Printer Agent with a queue. 


. Have users install the iPrint Client and iPrint printers. 


o nu A nn A U N 


. Once all queues have been migrated to iPrint, you can delete the Print Server, Printer, and Print 
Queue objects, and unload pserver.nlm from the server. 


Setting Up DNS for the Print Manager 


Prior to configuring printers for iPrint, you should configure a DNS name for each Print Manager. 
When iPrint is enabled for a printer, a URL is generated based upon the Print Manager’s IP address 
or assigned DNS Name. Beginning with NetWare 6.5, if a DNS name is not assigned to a Print 
Manager, by default the Print Manager will use the server’s IP address when generating the printer 
URL. 


For example, if a Print Manager resides on a server using an IP address of 172.16.123.25 and the 
printer name is Printerl, then iPrint generates a URL of ipp://172.16.123.25/ipp/Printer1. If you 
assign a DNS name to the Print Manager of Printing. MyCompany.Com and the printer name is 
Printerl, then the URL is ipp://Printing. MyCompany.Com/ipp/Printer1. 


By using a DNS name, you can change the server’s IP addresses without affecting a printer’s URL. 
To correctly enable DNS for each Print Manager, you must complete the following tasks: 

1. Add the DNS name to the DNS name server 

2. Enable DNS on the Print Manager 


If you do not implement DNS before using iPrint or change a Print Manager’s DNS name, be 
aware of the following issues: 


+ IfDNS is not set up for the Print Manager and the manager is moved to another server, users 
must reinstall their iPrint printers. 


+ Ifa DNS name is added to the Print Manager after iPrint is set up, iPrint printers enabled 
before DNS will not use the DNS name until the manager is restarted. 


¢ Ifusers install printers before the DNS name is added, their printing will work only until the 
IP address of the Print Manager changes. Then users must reinstall their printers. 
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Adding the DNS Name to the DNS Name Server 


See your DNS name server documentation for more ifnormation. If you are using NetWare for 
your DNS name server, see the Novell DNS/DHCP Services Administration Guide for NetWare 
6.5. 


Enabling DNS on the Print Manager 


To configure a DNS name for the Print Manager, use the Print Manager command line startup 
switch, /dnsname=DNS_name. If you use a DNS name that is not contained in the server’s 
sys:etc\hosts you will receive an error when you load the Print Manager. 


Syntax 


ndpsm Print_Manager_Object_Name /dnsname=Print_Manager_DNS_Name 


Example 
ndpsm PrintManagerl /dnsname=Printing.MyCompany.Com 


where PrintManagerl is the Print Manager name and Printing. MyCompany.Com is the desired 
DNS name. 


You need to use the DNS startup switch only once. After the startup switch is used, the Print 
Services Manager will remember the DNS name until a different DNS name is specified. To 
change the DNS Name, use the switch with the new DNS name. If you do not specify an IP address 
or DNS name when you load the Print Manager, the manager uses the server’s IP address. If either 
the IP address or DNS name specified on the command line or in the sys:etc\hosts file is invalid, 
you will receive one of the following errors: 


IP Address XXX.XXX.XXX.XXX, specified at load time, is not bound. 
Program execution cannot continue normally. Press Escape to continue. 


or 
The NDPS Manager can not resolve the DNS name xxx. 


To resolve this error, use a valid DNS name or IP address for the Print Manager at the system 
console prompt or edit the sys:\etc\hosts to contain a valid address. See the Novell DNS/DHCP 
Services Administration Guide for NetWare 6.5 for more information. 


NOTE: When loaded, the Print Manager appears in the IP Management list of NetWare Remote Manager. 
However, if IP Management cannot validate the DNS name being used, the Print Manager does not appear in 
the list. If you want the Print Manager to appear in the IP Management list, you must add the DNS name you 
assigned to the Print Manager to sys:etc\hosts. 


For more information about NetWare Remote Manager, see the NetWare 6.5 Remote Manager Administration 
Guide (http://www.novell.com/documentation/lIg/nw65/remotemgr/data/a7hjvxo.html) 


Creating a Broker 


Ideally, you should place a Broker on each server running a Print Manager. This requires you to 
create a separate Broker object in eDirectory for each Broker that will be loaded.This configuration 
allows the Print Manager to connect directly with each Broker without sending data across the 
network. 
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If you are unable to place a Broker on each server running a Print Manager, you will want your 
Brokers sufficiently well distributed so that your brokered services (Service Registry Service, 
Event Notification Service, and Resource Management Service) will be readily available on the 
system when needed. Each eDirectory tree should have at least one Broker. 


To minimize traffic across a WAN link, you might want one Broker running at each physical WAN 
location. 


4 In Novell iManager, click ¡Print > Create Broker. 
2 Fill in the fields. 

Click Help for explanations about the fields. 
3 Click OK. 


4 To autoload the Broker when you bring up the server, add the following line to your server's 
autoexec.ncf file: 


load broker Broker_name_and_context 
For example: 


load broker .brokerl .corp.acme 


To modify the Broker properties, click Manage Broker, and then select the Broker you want to 
modify. 


Add Printer Drivers 


A printer driver is a software entity that directly supports a physical printer, enabling it to carry out 
its functions. 


Hardware vendors develop printer drivers, which are specific to each printer. Most printers require 
different printer drivers for each operating system they interact with. You can view a complete list 
of printer drivers currently stored in a Broker, and you can add additional printer drivers from 
diskettes, CDs, and the workstation operating system. The Broker must be running to add printer 
drivers. 


Printer drivers cannot be installed from multiple diskettes. If a printer driver or other resource is 
shipped on more than one diskette, copy the files to a directory on a hard disk or network drive and 
install it from there. 


To add printer drivers to thBrokere: 
1 In Novell iManager, click Manage Broker and then browse to and select the Broker you want. 
2 Click Drivers and then select the client platform you want to work with. 
3 Do one of the following: 
+ Click Add from file to add drivers from a printer driver .inf file 
+ Add from System to add drivers from the workstation you are running ¡Manager from. 


The drivers installed on your workstation are made available for upload to the Broker. 
You can upload only drivers for the same platform as the workstation. 


4 Select the driver you want, then Click OK. 


5 Click OK to save your changes. 
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Creating a Print Manager 
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A Print Manager provides a platform for Printer Agents that reside on the server. The Print 
Manager object stores information used by the NetWare Loadable Module™ (NLM™), 
ndpsm.nlm. You can manually load this NLM at the server console. A Print Manager must be 
created as an object in the eDirectory tree before you can create server-based Printer Agents. 


A single Print Manager can control any number of Printer Agents. 


Although you can perform some configuration and management tasks directly through the Print 
Manager console interface, Novell ¡Manager is the main tool for performing these tasks. 


Use the following guidelines to determine where and when to place a Print Manager. 


+ Only one Print Manager can be loaded per server. A server that has a printer connected 
directly to it requires a Print Manager to be loaded on that server. 


+ Whenever possible, place the Print Manager and the printers it controls on the same LAN 
segment for optimal performance. 


+ You might want to consider distributing your printer agents across multiple NDPS Managers 
so that if one NDPS Print Manger goes down, not all of the printer agents are impacted. 


Ensure that you have Supervisor rights for the container where the Print Manager object will be 
reside. For each Print Manager that will be loaded, a separate eDirectory Print Manager object 
needs to be created. 


1 In Novell iManager, click ¡Print > Create Print Manager. 
2 Fill in the fields. 
Click Help for explanations about the fields. 


IMPORTANT: If you move the Print Manager to a different server, its database also moves. As a result, 
local printers assigned to this Print Manager no longer work. To avoid this, you can assign a DNS name 
to the Manager before creating Printer Agents associated to it using the /dnsname= startup switch. For 
more information, see “Moving the Print Manager” on page 51. 


Any printer you designate as a local printer when you are configuring Printer Agents assigned to this Print 
Manager must be directly attached to this server. 


3 Click OK. 


4 To load the Print Manager, click Manage Print Manager, browse to and select the Print 
Manager you created, click Load. 


To autoload the Print Manager when you bring up the server, add the following line to your 
server's autoexec.ncf file: 


load ndpsm Print_Manager_name_and_context 
For example: 


load ndpsm .sales_manager.corp.acme 


To modify the Print Manager properties, click Manage Print Manager, then select the Manager you 
want to modify. 


For a discussion of Access Control roles, see “Setting Access Control for the Print Manager” on 
page 74. 
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Creating a Printer 


Prerequisites 


Procedure 


Before you can create a printer, you must first create a Print Manager on your server. See “Creating 
a Print Manager” on page 24 for more information. 


After creating a Print Manager, you can create printers. Printers added to the eDirectory tree by 
Novell ¡Manager are referred to as controlled access printers. As eDirectory Printer objects, access 
to the printers can be controlled depending on the level of security chosen and if SSL is required. 


When you use Novell ¡Manager to create a Printer object you will need to select a gateway. The 
gateway handles communication between the Print Manager and the printer. Most printers will 
work with the Novell gateway (ndpsgw.nlm). Some printer vendors have created their own 
gateways to provide proprietary printer specific information. 


To use a third-party print vendor’s gateway, you must use NetWare Administrator to create the 
Printer object. 


U Have Supervisor rights for the destination container where its associated Printer object will 
reside 


U Be designated as a Manager of the Print Manager that will control this Printer Agent 


U Have a Broker running 


U Have a Print Manager running 


When you create a new Printer, ¡Print is enabled by default. 
1 In Novell iManager, click ¡Print > Create Printer. 
2 Fill in the fields. 
Click Help for explanations about the fields. 
3 Click Next. 
4 Select the printer driver for each client operating system. 


These drivers will be automatically downloaded to users' workstations when they install this 
printer in the future. 


If you choose a Windows 3.x driver but not a Windows 95/98/ME or Windows NT/2000 
driver, a 16-bit driver will be selected. Normally this will not create problems. 


Because the list of printer drivers shipped with this product is limited, you can add drivers to 
the Resource Management Service database. (See “Adding or Updating Printer Drivers” on 
page 66 for more information.) 


If the driver you need is not in the drivers list, rather than adding it to the RMS, you can select 
[None] at the top of each list. Users will then be asked to provide a disk with the appropriate 
driver the first time they install this printer on their workstations. 


5 Click Continue. 
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Enabling ¡Print on Existing Printers 


What’s Next 


When you create new printers with Novell iManager, iPrint is enabled by default. If you have 
existing printers and want to enable iPrint, complete the following steps. 


If you have a large number of printers that you want to enable iPrint on, use this iManager task to 
avoid enabling iPrint on each individual Printer object. 


1 
2 
3 


In Novell iManager, click iPrint > Enable iPrint Support. 
Browse to and select the Print Manager you want to enable IPP printing on. 


To enable all printers associated with this Print Manager, check the first check box next to 
Enabled. 


To select printers individually, check the check box next to each printer in the Enabled 
column. 


(Optional) To enable all printers associated with this Print Manager to use Secure printing, 
check the first check box next to Secure. 


To select secure printers for specific printers, check the check box next to each printer in the 
Secure column. 


For more information on implementing secure printing, see “Secure Printing Using SSL” on 
page 76. 


To update the printer settings, click Apply or OK. 


With iPrint now installed on your server, you need to distribute the iPrint Client to your Windows 
clients and determine how users will access the system. 


+ 


+ 


Chapter 3, “Setting Up iPrint on Client Workstations,” on page 27: Helps you deploy the 
iPrint Client to workstations and explains the features of the client. 


Chapter 4, “Customizing iPrint,” on page 37: With your print system set up and the client 
distributed to the workstation, you can focus on how your users can access and install iPrint 
Printers. 
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Setting Up ¡Print on Client Workstations 


In order for users to use iPrint, they need to install the Novell® ¡Print Client software and a printer. 
When a user selects a printer to be installed by iPrint, ¡Print checks to see if the Novell ¡Print Client 
software is installed and then installs it if necessary. Then the printer driver is downloaded and the 
printer is installed in the user’s Printer folder. 


This section helps you with the following: 
+ Installing the ¡Print Client (page 27) 
+ Updating the ¡Print Client (page 29) 
+ Installing Printers (page 29) 
+ Configuring the ¡Print Client Settings (page 29) 
+ Implementing ¡Print Using DOS Commands (page 31) 
+ Using ¡Print with NetIdentity (page 33) 
+ Manage Global Actions through Iprint.ini (page 33) 
+ Uninstalling the Novell ¡Print Client (page 35) 


Installing the ¡Print Client 


Client Requirements 


In order for ¡Print to work properly, workstations should have the following: 
AU Windows 95/98 or Windows NT*/2000/XP Professional 


IMPORTANT: To install a printer on Windows NT/2000/XP, you must have Administrator rights or be a 
Power User on Windows NT/2000. 


Q Web browser with JavaScript* enabled and 
+ Microsoft Internet Explorer 5.0 or later 


+ Netscape 4.76 (¡Print is not supported on Netscape 6) 


Downloading and Installing the ¡Print Client 


You can download and install the ¡Print client from the default printer list page that resides on the 
server where the Print Manager is loaded. To reach the default page, enter the following URL in 
your Web browser: http://server_IP_address_or_dns_name/ipp. After installing the ¡Print client, 
you can install the printers from the list. 


For example, if the DNS name for printing is printing.mycompany.com, then the user would access 
iPrint from the following URL: 
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http://printing.mycompany.com/ipp 


If users need to print through a secure port using SSL, they should use /ipps instead of /ipp in the 
URL. This requires users to authenticate using their eDirectory™ usernames and passwords. Using 
the above example, this URL would be the following: 


https://printing.mycompany.com/ipps 
1 From a Netscape or Internet Explorer browser, enter the ¡Print URL. 
2 If the ¡Print client is not installed, you are prompted to install it. 
3 From the list of available printers, click the printer you want to install. 


During the printer install, ¡Print downloads and installs the printer driver, if one is associated 
with the printer and adds the printer to the user’s Printer Folder. The first time a printer is 
installed, printer drivers are forced to the workstation, even 1f the workstation contains a 
newer driver. Periodically, ¡Print checks to see if a newer driver has been added to iPrint’s 
Resource Management Service. For more information on using Resource Management 
Services to distribute and update printer drivers, see “Understanding the Resource 
Management Service” on page 100. 


NOTE: If you receive an error that no printer driver is associated with a printer, you need to associate a 
printer printer using the Manage Printer task in iManager. See “Adding or Updating Printer Drivers” on 
page 66 for more information. 


4 Users can print to the printer by selecting the printer from any application. 


You can also make the ¡Print client and printers available by creating location-based printing or 
using ZENworks®. 


Creating Location-based Printing 


Location-based printing lets users select printers based on location by using a list view or a map. 
Using a list view, printer locations can be displayed by building, office location, eDirectory 
context, etc. You can configure the lists in a way that best suits the users’ needs. 


For more information, see “Creating Printer Lists” on page 40. 


Using the iPrint Map Designer, you can create maps of printer locations by using drag-and-drop 

technology. Once the maps are created, they can be posted on a Web server for users to access. As 
users view the maps, they find a printer close to their location and then click its icon. The client 

software (if not yet installed) and the printer are installed on their workstation. 


For more information, see “Creating Location-Based Maps with ¡Print Map Designer” on page 37. 


Using ZENworks to Distribute iPrint 


28 


You can use ZENworks to distribute the Novell iPrint Client and printers to users’ workstations. 
You take a snapshot of a workstation before installing the client and another snapshot after. 
ZENworks creates a list of files to install and makes the necessary changes to the Windows 
Registry. 


You could also use ZENworks to install an HTML file on the users’ workstations that would take 
them to your iPrint Web site. This would save you from having to distribute a URL to your users. 
Many other implementations are at your fingertips depending on your specific needs. For more 
information on using ZENworks, see the ZENworks online documentation (http:// 
www.novell.com/documentation/ZENworks.html). 
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Updating the ¡Print Client 


Periodically, users will need updates to the Novell ¡Print Client. You will need to decide on how 
you want to manage this. You can allow ¡Print to automatically update the clients or you can 
choose to distribute a newer client using a software distribution package like Novell’s ZENworks. 


See “Updating the ¡Print Client Automatically” on page 34 for more information. 


Installing Printers 


Using the ¡Print Printer List 


iPrint generates a list of printers associated with a Print Manager that can be used to install the 
iPrint Client, install an ¡Print printer, or check the status of a printer. 
1 Enter the URL of the ¡Print Manager server in your Web browser Address field. 
The Printer List Page is located at http://server_1P_ address_or_dns_name/ipp. 
2 From the list of available printers, select the printer you want to install. 
If the ¡Print Client is not installed when you select a printer, install it when prompted. 


NOTE: Beginning with NetWare® 6.5 Support Pack 2, the iPrint Client is no longer required to view the 
printer list; however, to install or view printer information, the client is still required. 


During the printer install, iPrint downloads and installs the printer driver, if one is associated 
with the printer, and adds the printer to the user’s Printer folder. The first time a printer is 
installed, printer drivers are forced to the workstation, even if the workstation contains a 
newer driver. Periodically, the iPrint Client checks to see if a newer driver is available. 


Creating Location-based Printing Web Pages 


Location-based printing lets users select printers based on locations by using a list view or a map. 
Using a list view, printer locations can be displayed using HTML pages broken down by building, 
office location, eDirectory context, etc. You configure the lists in a way that best suits the users’ 
needs. For an example of using a list view, see 
sys:\login\ippdoc\examples\example2\innerweb.htm. 


For more information, see “Creating Printer Lists” on page 40. 


Using the iPrint Map Designer, you can create maps of printer locations by using drag-and-drop 
technology. After the maps are created, they can be posted on a Web server for users to access. 
When users view the maps, they can find a printer close to their location and then click its icon. 
The client software (if not yet installed) and the printer are installed on their workstation. For an 
example of using a list view, see sys:\login\ippdocs\examples\example1\innerweb.htm. 


For more information on using the ¡Print Map designer, see “Creating Location-Based Maps with 
iPrint Map Designer” on page 37. 


Configuring the ¡Print Client Settings 


Use the ¡Print Cliente configure the following ¡Print services: 


+ Using a Proxy Server (page 30) 
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¢ Setting Up ¡Print on Terminal Servers (page 30) 
+ Using the Novell ¡Capture LPT Port Redirector Utility (page 31) 


Using a Proxy Server 


A proxy server sits between a client and another server that the client is trying to communicate 
with. Often proxy servers are used in conjunction with a firewall to keep internal addresses private 
while only exposing the proxy server’s address to external users. If you are using a proxy server 
and have users that need to submit print jobs through a proxy server, you can use the ¡Print Clients 
Proxy setting. The client sends all print-related requests, like a print job, to the proxy server. The 
proxy server then redirects the print job to the correct ¡Print server. 


For example, Juan is a laptop user and has installed and printed to a variety of 1Print printers at the 
company’s headquarters. While out on the road, Juan wants to submit a report to his boss. Rather 
than sending the report by e-mail or fax, Juan decides to send it to the printer near his boss. When 
he tries to send the report to the printer, he receives an error that the printer cannot be found. He 

knows that the company uses a firewall and a proxy server. He types the proxy server address in 
the ¡Print Proxy settings, then tries to print the report again. This time the print job is accepted. The 
print job travels from his laptop to the proxy server. The proxy server redirects the print job to the 
printer’s Print Manager, where the print job is spooled and forwarded to the printer. 


To set the proxy server address in iPrint: 
4 Click Start > Programs > Novell ¡Print > iPrint Settings > Proxy. 
2 To use a proxy server, check the check box and then specify the URL for the proxy server. 
3 Click OK. 


To disable using a proxy server, uncheck the check box. 


Setting Up iPrint on Terminal Servers 


You can set up ¡Print on a terminal server to allow terminal server clients to install and print to 
iPrint printers. 


Installing the iPrint Client on a Terminal Server 
1 Log in to the terminal server with Administrator or equivalent rights. 
2 Install the iPrint Client. 


The iPrint Client can be downloaded from the iPrint default page or by copying and executing 
nipp.exe from the iPrint server in sys:\apache2\htdocs\ippdocs. 


NOTE: On terminal servers, the client auto update will not work. To update the client with a newer release, 
you must install it manually. 
Configure iPrint for Terminal Server Clients 


You can configure iPrint to work in any of the following ways, depending on the rights the terminal 
server client has. 


¢ Install user printers only: User printers can only be installed and deleted by the user who 
installed the printer. User printers are not available to other users on the workstation. 
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¢ Install workstation printers Only: Workstation printers can be installed and deleted only by 
users with sufficient rights. After a workstation printer is installed, all users using the 
workstation can print to 1t. 


+ Try to Install workstation printer First: If the user has insufficient rights to install the 
printer, the printer is installed as a user printer. 


To configure iPrint for terminal server clients: 
1 Log in to the terminal server with Administrator or equivalent rights. 
2 Click Start > Programs > Novell ¡Print > ¡Print Settings. 
3 Click Terminal Server > select the configuration option you want. 


4 Click OK. 


Using the Novell ¡Capture LPT Port Redirector Utility 


The Novell ¡Capture LPT Port Redirector lets you capture LPT ports and redirect the output to 
iPrint printers. Novell ¡Capture is installed when you install the ¡Print Client. Before using the LPT 
Port Redirector, you must have ¡Print printers installed on the workstation and the Print Manager 
and Printer Agents must be up and running. This feature is not available on terminal servers. 


For example, Olga uses a legacy MS-DOS application to run reports. The application can print 
only to an LPT port. With the ¡Print Client installed, Olga installs an ¡Print printer on her 
workstation and uses Novell ¡Capture to capture the LPT port. ¡Capture redirects any data sent to 
the LPT port to the ¡Print printer. Olga can now run her MS-DOS application from her Windows 
workstation and send print jobs to an ¡Print Printer 


To run the utility: 
4 Click Start > Programs > Novell ¡Print > ¡Print Settings > ¡Capture. 
2 Select the port you want to capture. 
3 Click Select Printer, select the ¡Print printer you want, then click Capture. 


If the printer you want is not listed, check to see that the printer agent is up and running and 
that the printer has been installed as an ¡Print printer. 


4 Click OK. 


You can also use the LPT Port Redirector to end a printer capture by selecting the port and clicking 
End Capture. 


IMPORTANT: Existing port assignments are not displayed, and ¡Print port assignments will supersede all 
other port assignments. ¡Print port assignments remain in effect, even after the workstation restarts, until you 
end the capture. 


Implementing ¡Print Using DOS Commands 


The following DOS commands let you install ¡Print printers without a Web browser and capture 
LPT ports to ¡Print printers. These commands are useful when you have legacy applications that 
require output to an LPT port, or you want to add printers through a login script. 


+ Icapture.exe 


+ Iprntcmd.exe 
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Using Icapture.exe to Capture Printer Ports 


Icapture.exe is a DOS command line utility that lets you capture LPT ports and redirect the output 
to 1Print printers. The utility is installed when you install the ¡Print Client, and it can be used from 
a DOS-box command line, called from a batch file, or called from a login script. 


IMPORTANT: Icapture.exe requires that the ¡Print printer be installed before the command is run. You can 
install a printer from the DOS command line using iprntcmd.exe. 


Use the following parameters when executing the icapture.exe command. 


Parameter Description 
LPTx or The port you want to capture. 
L=x 


where x is the port number 


P=printer_name The name of the printer that 
appears in the Printers Folder 
after the iPrint printer is installed. 


EndCap Ends the capture to the specified 
port. 


NOTE: Captured ports remain 
captured, even through a 
workstation restart, until you end 
the capture. 


Show Displays the status of currently 
captured ports and their 
associated printers. 


Syntax 


icaptureparameters 


Examples 
For example, to capture a printer named Printerl to port number 2, you would enter either: 


icapture 1=2 p=printerl 


or 
¡capture Ipt2 p=printerl 

To end the capture, you would enter either: 
icapture endcap 1=2 

or 


icapture endcap 1pt2 


Using Iprntcmd.exe to Install ¡Print Printers 


If you need to install an ¡Print printer but cannot use a Web browser, you can use the iprntemd.exe 
command at a DOS prompt.The iprntemd.exe command can install, remove, or set a printer as the 
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Syntax 


Examples 


default printer. This command is most often used in login scripts in conjunction with the 
icapture.exe command. Use the following parameters when executing the icapture.exe command. 


Options Description 

add Installs the specified printer. 
remove Removes the specified printer. 
temporary Installs the specified printer for 


this session only. When the 
workstation is rebooted, the 
printer is removed. 


default Sets the specified printer as the 
default. 


iprntcmd iprint_printer_url parameters 


To install a printer named ColorPrinterl and set it as the default printer, you would enter the 
following for nonsecure printing” 


iprntcmd ipp://printing.mycompany.com/ipp/ColorPrinterl /add /default 


iprntcmd http: //printing.mycompany.com:631/ipp/ColorPrinterl /add /default 
NOTE: When using the http://, you need to specify the port number. 


To install a printer named ColorPrinterl and set it as the default printer, you would enter the 
following for secure printing: 


iprntcmd https://printing.mycompany.com/ipps/ColorPrinterl /add /default 


Using ¡Print with Netldentity 


The Netldentity agent works with eDirectory™ authentication to provide background 
authentication to Windows Web-based applications that require eDirectory authentication. ¡Print 
supports the NetIdentity agent included with NetWare 6.5 running on Windows NT/2000/XP only. 
If the NetIdentity agent is installed on the workstation, iPrint will use NetIdentity when 
authenticating. For more information on using NetIdentity, see the Net/dentity Administration 
Guide for NetWare 6.5. 


Manage Global Actions through Iprint.ini 


A configuration file named iprint.ini is located in sys:\apache2\htdocs\ippdocs\ on each server 
where an iPrint Manager is running. The file controls the following tasks: 


+ “Updating the ¡Print Client Automatically” on page 34 
+ “Creating an Installed Printer Name Profile” on page 34 
+ “Installing User Printers” on page 34 


¢ “Setting Printer Persistence” on page 35 
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Updating the ¡Print Client Automatically 


When a user starts his machine, ¡Print checks the default printer to ensure the user is using the latest 
Novell ¡Print Client. When needed, a newer client is installed. Using a configuration file, you can 
control how this update takes place. 


An iprint.ini configuration file is located in sys:\apache2\htdocs\ippdocsV on each server where 
1Print is installed. This file controls whether the user is prompted before the updated client is 
installed or the updated client is installed without user intervention. When the client is installed 
without user intervention, the user still sees the installation program. 


1 Using a text editor, edit sys:\apache2\htdocs\ippdocs\iprint.ini. 
2 Change the AllowAutoUpdate setting for the desired behavior. 
3 Save the file. 


IMPORTANT: The iprint.ini file should be synchronized across all servers where iPrint and an iPrint 
Manager are running. 


NOTE: After the iPrint Client is updated, Windows 9x users will have to restart their machines. Windows NT/ 
2000/XP users should not have to immediately reboot, unless they are using iPrint utilities to capture LPT 
ports. 


Creating an Installed Printer Name Profile 


By default, the installed printer name on the client follows the full UNC/URL format: \\ipp:// 
dns_name\printer_name. An example of a printer name in this format is Wipp:// 

Printing. MyCompany.Com\ColorPrinter. These printer names are often too long to fit in an 
application’s display field for the printer name. Using an Installed Printer Name Profile, you can 
replace the UNC server name (or dns_name) for all printers on a Print Manager with any name you 
want to be displayed. For example, if you want to display just the company name, the above 
example would display as \\MyCompany\ColorPrinter. 


The Installed Printer Name Profile is available only on Windows NT, 2000, and XP workstations. 
When you implement an Installed Printer Name Profile, printers that are already installed are not 
affected. Only newly installed printers after the change will have the shortened name. For printers 
already installed, you have to delete and reinstall the printers to realize any changes to their names. 


4 Open sys:\apache2\htdocs\ippdocs\iprint.ini in a text editor. 
2 Change the value of the ShortInstallName parameter to the value you want displayed. 
ShortInstallName=your_name 


where your_name is the value you want displayed. To reset the parameter to its default setting, 
use “default” as the value. 


IMPORTANT: The iprint.ini file should be synchronized across all servers where iPrint and a Print Manager 
are running. The Installed Printer Name Profile affects all printers on a Print Manager. 


Installing User Printers 


34 


To install an iPrint Printer and the associated printer driver users, must have Administrator or 
equivalent rights on Windows NT/2000/XP or Power User rights on Windows NT/2000. User 
Printers allows users to install a printer without having those rights, but that printer is available 
only to that individual user when he or she logs on to Windows. 


For example, three workers — Albert, Juan, and Carla — share the same computer during the day. 
Albert prints to an accounting printer, Juan prints to a plotter, and Carla prints to a printer in the 
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CEO’s office. Using User Printers, each worker can install the printer they need but cannot see 
printers installed by the other users. 


To configure User Printers, edit the iprint.ini file located in the sys:\apache2\htdocs\ippdocs 
directory of the server where the iPrint html pages are installed by changing the value for 
AllowUserPrinters = entry. The iprint.ini file contains information about the different possible 
values for this entry. 


Setting Printer Persistence 


You might want printers to remove themselves automatically from a workstation. For example, if 
you have a printer in your lobby for customers to use, you would want the printer to be removed 
from the customer’s laptop when the customer leaves. Setting the persistence of the printer lets you 
automatically remove the printer when the customer reboots the laptop. 


To use Printer Persistence, you must use the iPrint Map Designer where you can set the persistence 
of a printer. The following table shows the different settings for persistence. For more information 
on the iPrint Map Designer, see “Creating Location-Based Maps with iPrint Map Designer” on 


page 37. 

Option Description 

persistent The printer is not removed. 

volatile-reboot The printer is removed when the workstation 
reboots. 

volatile-date-time The printer is removed at the indicated time. Use 
the numerical format of year, month, day, hour, 
minute. 


For example,8:16 pm on March 2, 2004 would be 
formatted as 


2004,3,12,20,16 


Uninstalling the Novell iPrint Client 


To remove the Novell iPrint Client, use Remove Programs option in the Windows Control Panel, 
or use the uninstall program that is available under the Novell iPrint program group in the Start 
menu. 


IMPORTANT: When you uninstall the iPrint client, all iPrint printers are removed from the workstation. 


What’s Next 


+ Chapter 4, “Customizing iPrint,” on page 37: With your print system set up and the client 
distributed to the workstation, you can focus on how your users can access and install iPrint 
Printers. 


+ Chapter 5, “Managing Your Print System,” on page 43: Helps you monitor and maintain your 
print system. 
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Customizing ¡Print 


This chapter describes how to customize ¡Print for your company by using the ¡Print Map Designer 
and modifying the HTML pages and ¡Print Client interface. 


¢ “Setting Up Location-Based Printing” on page 37 
+ “Customizing the ¡Print HTML Interface” on page 40 
+ “Changing Printer Driver Default Install Options” on page 41 


Setting Up Location-Based Printing 
When setting up location-based printing, you can use the ¡Print Map designer to map the location 
of printers or create printer lists to help users find a printer closest to them. 
+ “Creating Location-Based Maps with ¡Print Map Designer” on page 37 


+ “Creating Printer Lists” on page 40 


Creating Location-Based Maps with ¡Print Map Designer 


Using the ¡Print Map Designer tool, you can quickly create a map showing printer locations. The 
tool lets you import floor plans as background images that can be used to drag-and-drop printers 
onto show actual locations. These maps are then published on a Web server so users can install 
printers that are closest to their location. 

Prerequisites 


QO) Microsoft Internet Explorer 5.5 or later 


O Novell® ¡Print Client installed on the workstation 


After the map is created, you must use the ¡Print Map Designer to modify or update it. Changes to 
a map file that are made outside of the ¡Print Map Designer are not supported. If you need to add 
links to a map, you should create a frameset file and then display the map file in one frame and 
display your links in a different frame. 


+ “Creating a Map for Printing” on page 37 

+ “Adding Printers from Different Print Managers” on page 39 
+ “Hosting Maps on a Web Server” on page 39 

+ “Modifying a Map’s HTML Code” on page 39 

+ “Using the Keyboard with ¡Print Map Designer” on page 40 


Creating a Map for Printing 


Before creating the map, ensure the following: 
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Q) Tppsrvr.nlm must be loaded. 


NOTE: If you run the map tool using HTTP and ippsrvr.nlm is not loaded, then you will receive a 503 
Service not available error. To resolve this, you need to enable ¡Print on one of the printers so that 
ippsrvr.nim will automatically be loaded. 


All of your background images (maps) are copied to 
sys:\apache2\htdocs\ippdocs\images\maps on the server and any custom printer icon images 
are copied to sys:\apache2\htdocs\ippdocs\images\printers. 


A default set of printer icons is included. 

These files are detected by iPrint Map Designer at startup. 

File types that can be used for background and printer icon images are JPEG, GIF, and BMP. 
To start iPrint Map Designer, do one of the following: 


+ Using a mapped drive, open sys:\apache2\htdocs\ippdocs\maptool.htm in Microsoft 
Internet Explorer. 


+ Open http://server_address:port/apache2/htdocs/ippdocs/maptool.htm where 
server_address is the server’s IP address or DNS name of the server where the printer 
agent is running. 


If you are want to save the map to this server, you need to be authenticated to the server. 
Select a map from the Background drop-down list. 
(Optional) Add a printer to the map. 
3a From the printer Icon field, select the type of printer and size. 

Sizes range from 1 to 6, with 1 being the largest. Icons with a C indicate color printers. 
3b Click the Printer icon and drag the printer to the desired location on the map. 


3c Next to the Printer List field, click the Browse icon and enter the IP address or DNS name 
of the server where the Print Manager is running. 


3d From the printer list, select the printer agent you want associated with this printer icon. 


If the printer is not listed, then you have not enabled IPP for the printer. See “Enabling/ 
Disabling iPrint on Individual Printers” on page 53 for more information. 


The Printer URL and Mouse Over Text is automatically filled in with the printer agent 
information. 


Printer URL: The URL created for the printer when IPP is enabled for the printer. You 
should not need to change the URL. 


Mouse Over Text: By default, displays the printer agent’s name. You can override this 
information by entering the text you want to display when a user moves the mouse over 
the Printer icon. 


3e (Optional) In the Printer Caption field, enter the information to display, using Enter to 
parse the information onto multiple lines. 


3f (Optional) On the menu bar, click Driver Settings to set the installed driver settings for 
this printer. 


These settings included paper size, orientation, copies, duplex, color, collate, and the 
option to remove the printer when the workstation is rebooted. 


If you delete a printer icon or change the printer agent assignment for a Printer icon, any 
driver settings are cleared for that icon. 
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3g (Optional) From the menu bar, click Font to change the b 
on the map. 


ase font, color and size for text 


4 (Optional) Edit a printer’s information by clicking the desired printer’s icon and then editing 


the printer information fields. 


To deselect a Printer icon while in the map, click anywhere in the design area. 


5 Click Save and save the map to sys:\apache2\htdocs\ippdocs. 


WARNING: If you click Refresh or exit Internet Explorer without saving the map, all changes made since 


the last time the map was saved will be lost. 


To retrieve and modify an existing map file, click Open and browse to the directory where the map 


is located. 


Adding Printers from Different Print Managers 


You can add printers from different Print Managers to the same m: 


ap. First, add the printers from 


one Print Manager. Then click the Browse icon and select a different manager. 


If you need to add or modify printers from a previously used Print Manager, click a Printer icon 
from that manager and the Printer List will be populated with printers from that manager. 


Hosting Maps on a Web Server 


After creating your maps, you need to post them on a Web server. Copy the contents of the \ippdocs 
directory and its subdirectories to the Web server in order for your maps and ¡Print to work 


properly. You can link to your maps from your company’s internal 
to your users. 


Modifying a Map’s HTML Code 


Web page or send the URL out 


By editing the HTML code of the map file you create, you can modify the persistence of a printer 
on the user’s desktop. This means that a printer can be removed at a certain time or after the 
workstation reboots, or it can be persistent (never removed). The default is persistent. 


NOTE: Beginning with NetWare 6.5 Support Pack 2, you can no longer m 
through a map’s HTML code. Instead, you can create a printer driver profile 
on page 56 for more information. 


odify the default driver settings 
. See “Using Printer Driver Profiles” 


To change the persistence of a printer to removed when the workstation reboots: 


1 Using an editor, open the map file you created using the ¡Print Map Designer. 


2 Scroll down the file until you find the printer you want to modify. 


The printer definition code will look like the following example: 


<!-- ipp_printer_1--> 


<DIV id="ipp_printer_1" style="position: absolute; left:505;top:373;" ALIGN="center"> 


<A name="ipp_printer_1" href="http://print.mycompany.com/apache2/htdocs/ippdocs/ 


ISINSTF.HTM?ippPrinterURL=ipp://print .mycompany.com/ipp/corporate- 
hp4050né&éonInstalled=statuséonNotInstalled=install"> 


<IMG name="ipp_printer_1" src="images/printers/ple.gif" alt="CORPORAT! 
<DIV ID="ipp_printer_1_caption"></DIV></DIV> 
3 Edit the code using the following syntax: 


&persistence=parameter: value; 


E-HP4050N" border=0></A> 
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The resulting code will look like this: 


<A name="ipp_printer_1" href="http://print.mycompany.com/apache2/htdocs/ippdocs/ 
ISINSTF.HTM?ippPrinterURL=ipp://print .mycompany.com/ipp/corporate- 
hp4050néonInstalled=statuséonNotInstalled=install;persistence=volatile-reboot"> 


4 Save the file. 


For more information on these settings, see “Setting Printer Persistence” on page 35. 


Using the Keyboard with iPrint Map Designer 


You can use the keyboard to create maps using iPrint Map Designer. The following table lists the 
tasks to complete and the corresponding keystrokes required. 


Task Press 


Move between fields Tab 
Insert Printer icon Insert 


NOTE: Before you can insert a printer, 
your focus must be the design area. 


Move printer icon within the design area Arrow keys 


Select a field Enter 


Creating Printer Lists 


Printer lists allow users to select printers using categories that are meaningful to them. For 
example, you could create a list of printers by building location, department names, eDirectory 
Context, etc. iPrint provides a default list of printers organized by Print Manager. To create a 
custom list, you must use an HTML editor and create links to the printer’s IPP URL. This URL is 
displayed when you enable IPP for a printer. 


To view a printer’s URL: 
1 From Novell iManager, click iPrint > Manage Printer. 
2 Browse to and select the printer you want. 
3 Click Client Support > iPrint Support. 
The printer’s URL is displayed under Accepted ¡Print URL. 
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You can edit any of the HTML files provided or you can create your own to customize iPrint for 
your environment. The HTML files are installed in the sys:\apache2\htdocs\ippdocs directory. For 
information on the HTML interface, see Appendix A, “Configuring the iPrint HTML Interface,” 
on page 79. 


Some examples of ways to present printers to users are located in the sys:\apache2\htdocs 
\ippdocs\examples directory: 


+ Example 1 shows a fully graphical interface for locating and installing printers using standard 
HTML. This type of approach can also be created using the iPrint Map Designer. For more 
information, see “Creating Location-Based Maps with iPrint Map Designer” on page 37. 
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Using your Web browser, view this example from 
sys:\apache2\htdocs\ippdocs\examples\example | \innerweb.htm 


+ Example 2 shows a lower maintenance approach for locating and installing printers using 
standard HTML. 


Using your Web browser, view this example from 
sys:\apache2\htdocs\ippdocs\examples\example2\innerweb.htm 


Changing Printer Driver Default Install Options 


You can choose the default settings for a printer driver when it is installed on the workstation. For 
example, in a law office you might want the default paper size to be 8-1/2 x 14. This means every 


time the printer and corresponding driver are installed on a workstation, the paper size is set to 8- 
1/2 x 14. 


Beginning with Support Pack 2, the ability to set the printer’s default settings has been removed 
from the iPrint Map Designer and moved to iManager. Any settings specified on a map are 
overwritten by the driver settings in iManager. To modify the printer’s default settings in 
iManager, see “Using Printer Driver Profiles” on page 56. 
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Managing Your Print System 


The following sections will help you manage the different components of your iPrint system. 
+ “Managing the Print Manager” on page 43 
+ “Managing Printers” on page 53 


+ “Managing the Broker” on page 63 


Managing the Print Manager 


Although the default settings allow your users to print without further configuration being 
necessary, you will probably want to modify some of those settings so that you can manage your 
printing resources most effectively. 


This section discusses the following: 
+ Using the Print Manager Health Monitor (page 44) 
+ Optimizing Fault Tolerance (page 50) 
+ Moving the Print Manager (page 51) 
¢ Print Manager Startup Switches (page 52) 


Understanding the ¡Print Manager Database 


The ¡Print Manager uses a database to store information about the printers it controls.The database 
creates a backup when you create or delete a printer, and every night at 1 a.m. The last four backups 
are saved. When a new backup file is created, the oldest file of the four stored files is deleted. If 
the oldest backup file is older than four days, then the ¡Print Manager creates a new backup. 


If the database fails to load through normal mechanisms, you can retrieve the database from 
eDirectory and load the ¡Print Manager on any other server in the eDirectory tree. 


IMPORTANT: You cannot restore a database from eDirectory to the same server that it was backed up from. 
In order to restore a database from eDirectory to its original source server, you must first restore it to a different 
server and then back up the database to eDirectory from that server. You can then restore it to its original 
server. 
Modifying the Database Backup Options 

1 At the server console, go to the Available Options menu for the ¡Print Manager. 

2 Select ¡Print Manager Status and Control > Database Options. 

3 Modify the desired settings. 


4 Escape back out to the Available Options menu. 
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Restoring a Database from eDirectory 


1 Atthe server where you want to restore the database, enter 
load ipsm /dbvolume=full NDS volume_name 
See “Print Manager Startup Switches” on page 52 for more information. 
2 Select the name of the ¡Print Manager whose database you want to restore. 


If the server with the original database is up and running, its name will appear in this menu. 
If the server is down, no server name will appear here. The only Source option available will 
be eDirectory (existing jobs will be lost). 


3 Select the source of the backup you want to restore. 
In most cases, you will be selecting eDirectory as the source. 
4 Select the volume where you want the database placed. 


The restored database is then copied to the location you selected. 


Using the Print Manager Health Monitor 


The Print Manager Health Monitor provides administrators with a global view of their print 
system. The Health Monitor shows you the current status of printer agents, and allows you to 
configure settings and generate reports about your system. The following are reviewed in this 
section: 


+ Understanding the Print Manager Health Monitor (page 44) 
+ Understanding the ¡Print Manager Database (page 43) 
+ Configuring Health Monitor Settings That Affect NetWare Remote Manager (page 46) 


+ Posting Administrator Messages about a Printer (page 46) 
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The Print Manager Health Monitor is a powerful tool to manage and troubleshoot your print 
system. The following examples show some of the features and information available in the Health 
Monitor. 


How can | tell which printers are not being used? 


The opening page of the Health Monitor shows all of your printers, their current state, and general 
statistics including the number of print jobs printed in the last hour, in the last day, and since the 
Print Manager was last started. 


A quick look at these statistics will help you identify which printers are not being used. By clicking 
a printer name, you can see additional details about the printer that can help you troubleshoot why 
users are not using this printer. 


For example, if the printer status shows Error printing, then click the printer for a list of 
known problems. If one of the known problems is Printer not connected, then use the IP 
address listed in the Load String field to ping the printer to determine if the IP address is valid. 


By looking at the statistical information, you can correct printer problems or make decisions about 
redeploying under used printers to departments that print a lot. 
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Are there any public access printers still in my print system? 


Many companies implemented print systems with public access printers—printers that are 
accessible to anyone. As security and budgets have become important issues, companies are 
migrating their public access printers to control access printers so that access to the printers can be 
managed through eDirectory™. 


Using the Print Manager Health Monitor, you can quickly scan all printers and determine if any 
public access printers still exist in the print system by generating a report of printer agents using 
the Associated NDS Printers report item. As you scan the report, you look for a printers with a 
listing of False, meaning they do not have an associated eDirectory Printer object. If a printer does 
not have an associated Printer object, then it is a public access printer. 

IMPORTANT: Novell recommends that all public access printers be converted to a controlled 
access printer by associating an eDirectory Printer object with the printer agent. This lets you to 


manage the printer through iManager, use the printer with iPrint, and take advantage of advanced 
iPrint features like auditing. 


l am migrating to iPrint. How can | tell if the printers have the correct settings? 


In order for iPrint to work correctly, printers must have IPP enabled and an associated printer 
driver. While you could use Novell iManager to look at each printer individually, you will find that 
generating a report showing all of your printers with these two settings to be a real time saver. 


Go to the Generate a report page, check the iPrint Enabled and driver types check boxes, and then 
generate a report. Now you can see which printers still need to be enabled for iPrint and which 
printers still need printer driver associated with them. 


Accessing the Print Manager Health Monitor 


The Health Monitor can be accessed from NetWare Remote Manager or from the Manage Print 
Manager page in iManager. From NetWare Remote Manager, complete the following. 


1 Use your Web browser to log on to NetWare Remote Manager at http://server_ip_address/ 
PsmStatus.html. 


2 Under Diagnose Server, click NDPS Manager Health. 


You can now view current printer agent states, startup/shutdown printer agents, and view other 
information about your print system. 


Generating Reports 


The report feature of the Health Monitor allows you to generate a report that can be displayed on 
the page or saved as a comma-separated-value (.CSV) file that can be used in a spreadsheet 
program. 


1 From the NDPS Manager Health Monitor main page, click Advanced NDPS Manager 
Information > Generate Report. 


2 Select the information you want included in the report by checking the corresponding check 
boxes. 


3 (Optional) To save the report as a file, click Write Results to File check box. 
4 Click Generate Report. 
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Configuring Health Monitor Settings That Affect NetWare Remote Manager 


You can configure settings in the Health Monitor to control how the Health Monitor affects the 
NetWare Remote Manager’s overall health indicator. Generally, you should keep the default 
settings unless you are instructed to make a change. 


41 From the NDPS Manager Health Monitor, click Configure Settings and Error Thresholds. 
2 Adjust the settings. 


See the online help for more information about the available settings. 


Posting Administrator Messages about a Printer 


Suppose a printer has been taken offline and sent to the manufacturer for repairs, but you keep 
getting phone calls from other administrators that the printer has an error in the Health Monitor. 
This can be resolved by leaving a message about the printer in Health Monitor. Users can see the 
message, but only administrators can edit it. 


1 From the NDPS Manager Health Monitor, click the printer you want. 

2 Click Message From Admin. 

3 Type the text you want displayed for this printer in the NDPS Manager Health Monitor. 
4 Click Apply. 


To remove a message, follow the steps above but delete the text in Step 3. 


Setting Up Printer Pooling 
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You can create a pool of printers to share the load of printing. Users install one of the printers in 
the pool. When a printer in the pool has a print job waiting, the Print Manager can redirect that 
print job to an idle printer in the pool. The Print Manager attempts to evenly distribute print jobs 
among all printers in a pool. For example, if 4 printers are in the pool and the first printer is printing 
a 100 page job, then the next print job will be sent to the second printer. If the second printer 
completes the print job, and the first printer is still busy, the next print job will be sent to the third 
printer. Printer pools are specific to the Print Manager, and a printer pool cannot span multiple 
Print Managers. 


Printers that are included in a pool should be the same model and use the same printer drivers. You 
can only include printers from the same Print Manager in a pool. 


When you create a printer pool, the pool information resides in the Print Manager and can only be 
viewed using Novell iManager. Unlike the Printers, and the Print Manager, a separate eDirectory 
object for a printer pool is not created. 


After you set up a printer pool, users install only one of the printers in the pool on their workstation. 
When a user submits a print job to the installed printer, the Print Manager will use the method 
above to send the print job to the next available printer in the pool. Users should be reminded that 
their print job might be printed by any printer in the pool. For this reason, the physical printers that 
are members ofa printer pool should be located close to one another. You might also want to enable 
banner pages, depending on the type of documents being printed. 


To set up printer pooling: 
1 From Novell iManager, click ¡Print > Printer Pool Configuration. 


2 Select the print services manager for this pool. 
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3 Select Create Pool from the Select An Operation list, then click OK. 
4 Specify the name of the printer pool. 

This name is only used to identify the pool within Novell iManager. 
5 Select the printers you want included in the pool. 


6 Click Next, then OK. 
To modify or delete a pool, follow the above steps and select the desired action from the Select an 
Operation list in Step 3. 
Using Print Auditing 


First you need to enable auditing using either Novell iManager or the NDPS Manager Health 
Monitor. 


When auditing is enabled for a printer agent, a log file is created indicating who printed how many 
pages to which printer on a given date. The log file is in a comma-separated format (.csv). The data 
from this log file can be viewed from the Health Monitor, or downloaded into a spreadsheet. 


3 Auditing Management - .PHB_MANAGER.NOYELL - Microsoft Internet Explorer 


HBBak -> - O AA | Qsearch [igFavorites media (4 A 4a8 
Address |@) https://137.65.46.24:8009/PsmStatus/Auditing/managment v| Go | Links Al File Edit View Favorites Tools Help 
iting Management - .PHB_MANAGER. NOVELL ENA] 


Audit Log 


Name Start Date and Time End Date and Time |File Size Job Count 


AUDIT.CSV |4-30-03 10:15 am | Active 738 3 Start New Audit Log | Generate Report 
AUDITOO4 CSV [4-29-03 1:10 pm 4-29-03 1:21 pm 729 6 | Delete Audit Log | Generate Report 
AUDITOO3.CSV [4-29-03 11:53am [4-29-03 1:10 pm 999 5 Delete Audit Log | Generate Report 
ALDITOO2,CSW |4-03-03 9:58 am [4-03-03 11:10am | 877 Kb 7,079 Delete Audit Log | Generate Report 


AUDITOO1. CSV |4-03-03 9:47 am 4-03-03 9:58 am 40 Kb 325 Delete Audit Log | Generate Report 


[E] Done TPB {i Internet Z 


From the Internal Auditing page you can complete the following tasks: 
+ “Using Novell iManager to Enable Auditing” on page 47 
+ “Using the Health Monitor to Enable Auditing” on page 48 
è Viewing Auditing Information (page 48) 
+ Managing Audit Logs (page 50) 
+ Downloading an Audit Report (page 50) 


Using Novell iManager to Enable Auditing 


4 In Novell iManager, click ¡Print > Enable Auditing, and then browse to and select a Print 
Manager. 


2 Select the printers you want to enable auditing for by clicking the check box in the Auditing 
column. Click the check box at the top of the column to enable auditing for all printers in the 
list. 
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Using the Health Monitor to Enable Auditing 


1 To access the NDPS Manager Health Monitor, open http: //server_IP_address/ 
PsmStatus in a Web browser address field. 


2 Click the printer you want to enable auditing for. 
3 Click Configuration Options. 
4 Click the Enable Auditing check box. 


Viewing Auditing Information 
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You can generate an audit report that shows all print jobs or you can filter the report based on a 
user or a printer or both. 


1 To access the NDPS Manager Health Monitor, open http://server_IP_address/PsmStatus in a 
Web browser. 


2 Click Advanced NDPS Manager Information > Auditing. 


3 Click Generate Report. If there is more than one audit log, click Generate Report for the audit 
log you want to view. 


4 (Optional) Filter the search by using the Limit Search by User and Limit Search by Printer 
filters. 


Z Audit File ‘AUDIT.CS¥" - Microsoft Internet Explorer -loj x| 


+ Back + => ~ @ A A| Qsearch (Favorites Media 9195-3908 


Address |Æ) https://137.65.46.24:8009/PsmStatus/Auditing?srcFile=AUDIT.CSY | ¿Go | Links A Henez 


Limit Search by User 


User Name [Starts With y] | | Search | 


BART(200-B0-D0-E4-45-00 


Limit Search by Printer 


Printer Name | Starts With y Search 
| a | Search] 


PCL XL 
PCL5 


Generate Report | 


| 
[ | [B® inte 


5 Click Generate Report to view the report. Only 250 print jobs are listed at a time. To view 
more print jobs in the report, click Next. 
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Auditing Information - Microsoft Internet Explorer 


=10Í x! 


EBak ~ > - Y A | Asearch [Favorites meda <4) B S Si E 


Address El https://137,65,46,24:8009/PsmStatus/Auditing?audCmpUserType=18:udSearchUserNa Y 


| 
@Go | Links >| Fie Edt Vier ? 


Report Summary 


NDPS Manager „Print MANAGER. NOVELL 
Audit Log AUDITOO4,CSW 
Selected User BART@00-BO-DO-E4-45-00 [Number of Jobs Currently Displayed | 6 
Selected Printer All Printers Page Count for Displayed Jobs | 12 
Audit Log Entries Scanned 60f6 
Job Owner Printer | Time Submitted | Time Completed gratin Hose ai Job Name 
BARTE00-BO-DO-E4-45-00 |PS 4-29-03 12:37 pm [4-29-03 1:10 pm | Completed 1 ¡26204 | Document 
BART@00-BO-DO-E4-45-00 | PS 4-29-03 12:37 pm |4-29-03 1:10 pm | Completed 1 [25956 | Document 
BART@00-BO-DO-E4-45-00 |PS 4-29-03 12:55 pm [4-29-03 1:10 pm | Completed 1 [28809 | Document >| 
[E] Done {| [A {@ Internet Ui 


The following table explains what is displayed in the report. 


Field Description 

NDPS Print The NDPS Print Manager that the information 
Manger is from. 

Audit Log The audit log filename that was used to create 


the report. 


Selected User 


Any user filter criteria that were used to create 


the report. 


Selected Printer 


Any printer filter criteria that were used to 


create the report. 


Number of Jobs 


The number of jobs submitted by the indicated 


users and printers. 


The following table explains what is displayed in the body of the report. 


Field Description 
Job Owner The owner of the print job. 
Printer The printer the print job was sent to. 


Time Submitted 
p 


rinter. 


The time the print job was submitted to the 


Time Completed 


The time the print job was printed on the printer. 
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Field Description 


Completion The completion status of the submitted print job. 


Status 
Completed, Cancelled by User, Cancelled by 


Operator, or Other, which indicates the job was 
aborted by the system. 


Page Count The number of pages printed. 

Job Size The size of the print job (in bytes). 

Job Name The print job filename that was submitted and 
the type of print client that submitted the print 
job. 


Managing Audit Logs 


From the Audit page you can manage your audit logs by using the displayed buttons. When audit 
logs are no longer needed you can delete them. On a daily, weekly or monthly basis, you might 
want to save the current data in the audit.csv file into a separate audit log to keep the log file more 
manageable. 


The active audit log file (audit.csv) logs data for all printers that have been enabled for auditing. 
You can generate a report from this file, or move the data to a saved file using Start New Audit 
Log. You cannot download the audit.csv file. To download a file it must be saved as a separate 
audit log. When you move the data to a saved audit log using the Start New Audit Log, the log file 
is named auditxxx.csv, where xxx is the next sequential number of the log. After a log file is saved, 
you can download the file to your workstation and import it into a spreadsheet program. 


Downloading an Audit Report 


When the file is downloaded, you can open the report in a spreadsheet application to sort, view, 
and format the data to meet your needs. The active audit log, audit.csv, cannot be downloaded. You 
must first start a new audit log by clicking Start New Audit Log, and then download the newly 
created audit log. 


1 On the ¡Print Manager Health Monitor main page, click Advanced ¡Print Manager 
Information > Auditing. 


2 Right-click the name of the audit log you want to download, then click Save Target As. 


3 Follow the prompts and save the file to the desired location. 


Optimizing Fault Tolerance 
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The Print Manager uses a database to store information about the printers it controls. This database 
is backed up and replicated in eDirectory™. The database is automatically backed up, by default, 
once a day. You can modify the backup options or manually backup the database using server 
console interface for the Manager. 


If the database fails to load through normal mechanisms, you can retrieve the database from 
eDirectory and load the Print Manager on any other server in the eDirectory tree. 


IMPORTANT: You cannot restore a database from eDirectory to the same server that it was backed up from. 
In order to restore a database from eDirectory to its original source server, you must first restore it to a different 
server, and then back the database up to eDirectory from that server. You can then restore it to its original 
server. 


Novell iPrint Administration Guide for NetWare 6.5 


Modifying the Database Backup Options 
1 At the server console, go to the Available Options menu for the Print Manager. 
2 Select NDPS Manager Status and Control > Database Options. 
3 Modify the desired settings, if needed. 
4 Escape back out to the Available Options menu. 


Restoring a Database from eDirectory 
1 At the server where you want to restore the database, enter 
load ndpsm /dbvolume 
See “Print Manager Startup Switches” on page 52 for more information. 
2 Select the name of the Print Manager whose database you want to restore. 


If the server with the original database is up and running, its name will appear in this menu. 
If the server is down, no server name will appear here. The only Source option available will 
be eDirectory (existing jobs will be lost). 


3 Select the source of the backup you want to restore. 
In most cases, you will be selecting eDirectory as the source. 
You will be prompted to select a volume. 

4 Select the volume where you want the database placed. 


The restored database is then copied to the location you selected. 


Moving the Print Manager 


Sometimes it is necessary to move the Print Manager from one server to another. If you assigned 
a DNS name to the Print Manager, you should update the DNS entry with the new IP Address the 
Manager is running on. 


WARNING: The URLs generated by ¡Print are based on the server's IP address or a DNS name. If you move 
a Print Manager to a server that has a different IP address or a different DNS name, a new URL is generated. 
Users must delete and reinstall their ¡Print printers. If you are using NDPS Printers, printing is not affected. 


1 Ifthe Print Manager is currently running, unload the it by clicking iPrint > Manage Print 
Manager. 


2 Browse to and select the Print Manager, and then click OK. 
3 Click Shutdown. 
WARNING: All printing associated with this Print Manager will cease and waiting print jobs will be lost. 
4 At the other server console enter 
load ndpsm 
If you need to use a startup switch, see “Print Manager Startup Switches” on page 52. 
5 Select the Print Manager object you want to load. 
A specific Print Manager can run only once. 


You will be prompted to download the database, and the Manager will start running. 
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Print Manager Startup Switches 
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To always load a Broker with the same startup switch, add the switch to the load Broker entry in 


the server’s autoexec.ncf 


Syntax: 


load ndpsm Print_Manager_name_and_ context /startup _ parameter 


Example: 


load ndpsm .sales_manager.corp.acme /dbvolume=sales_sys 


The following table lists the startup switches you can use when loading ndpsm.nlm. 


Startup Parameter 


Description 


nodatabase Load the Print Manager without opening the database. The 
Database Options menu is displayed which lets you examine, 
backup, restore, resynchronize, and uninstall the Print Manager 
database. 

noipx The Print Manager will not support the IPX™ protocol. 

noip The Print Manager will not support the IP protocol. 


dbvolume=full_NDS_volume_ 
name 


Download the database from NDS® and reconnect pointers to 
the local server where the command is executed. This is useful 
for moving the Print Manager to a new volume. 


dbvolume=nocheck 


The Print Manager will not validate that the database volume is 
local. This is used with Clustering. 


setens=broker_name 


Set the Event Notification Service to the specified Broker for all 
printers associated this Print Manager. 


setrms=broker_name 


Set the Resource Management Service to the specified Broker 
for all printers associated this Print Manager. 


qloadbalance 


The Print Manager evenly distributes the waiting print jobs 
among printers that are ready. This is used when pooling 
printers. 


iprinton 


The iPrint attribute is turned on for all printers associated with the 
Print Manager. 


dnsname=NDPSM_DNS_name 


This sets a DNS name to a Print Manager object. You will need 
to include the DNS information in your DNS lookup tables. 


You use this switch only once, and the Print Manager will use the 
same DNS name each time it is loaded. To change the DNS 
name, use the switch with the new name. 


If you included the DNS Name before deploying printing with this 
manager, then you can easily move the Print Manager to another 
server without disrupting printing. 


NOTE: The DNS name must be assigned before printing on the 
Print Manager is deployed. 


Novell iPrint Administration Guide for NetWare 6.5 


Managing Printers 


Although the default settings allow your users to print without further configuration being 
necessary, you will probably want to modify some of those settings so that you can manage your 
printing resources most effectively. While most tasks can be done in Novell iManager, some tasks 
will require you to use NetWare® Administrator. 


This section discusses the following: 
+ Enabling/Disabling ¡Print on Individual Printers (page 53) 
+ Moving Printer Agents to Another Print Manager (page 53) 
+ Managing Printer Agents (page 54) 
+ Configuring Printer Settings (page 59) 
+ Optimizing Event Notification (page 60) 
¢ Setting Print Job Spooling (page 62) 
+ Supporting Queue-Based Client Workstations (page 62) 


Enabling/Disabling iPrint on Individual Printers 
4 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer you want to enable IPP printing for. 
3 Click Client Support > iPrint Support. 
4 Check the Enable iPrint Support Access check box. 


The URL that appears in the Accepted IPP URL(s) box is the URL used when the printer is 
created on a workstation. This is also the URL you should use when creating iPrint maps. For 
more information, see “Creating Location-Based Maps with iPrint Map Designer” on 

page 37. 


To disable iPrint, uncheck the check box. 

5 (Optional) For secure printing, check the Require SSL and User Authentication check box. 
For more information, see “Secure Printing Using SSL” on page 76. 
This requires users to authenticate to eDirectory using their usernames and passwords. 


6 To update the printer settings, click Apply or OK. 


Moving Printer Agents to Another Print Manager 


Using Novell iManager, you can move printer agents to a different Print Manager. 


WARNING: The URLs generated by iPrint are based on the server’s IP address or a DNS name. If you move 
a Printer to a server that has a different IP address or a different DNS name, a new URL is generated. Users 
must delete and reinstall their printers. If you are using NDPS Printers, printing is not affected. 


1 From Novell iManager, click ¡Print > Manage Print Manager, and then browse to and select 
the Print Manager. 


2 Click Printer Agents, then click Move. 
3 Select the printer agents you want to move by checking the check box next to them. 


4 Click Move, and then select the Print Manager where you want the printer agents moved to. 
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5 Click Ok. 


You will want to ensure that the same printer drivers are available to the printer agents. 


Managing Printer Agents 


Using ¡Manager you can manage printer agents. You can start up/shut down a printer agent, pause/ 
resume input and output, view printer information, set configuration settings and change the 
printer drivers. 


1 From your Web browser, log in to Novell iManager. 

2 Click iPrint > Manage Printer, and then browse to and select the printer you want to manage. 
3 Click OK. 

4 Use the tabbed Property Pages to complete the task you want. 


Managing Print Jobs 


The following sections provide specific information about the print job management features. All 
of the procedures listed below can be performed either through NetWare Administrator or through 
the Novell Printer Manager. Users designated as managers or operators for a printer can perform 
these tasks for all jobs routed to that printer; individual job owners can only perform these tasks 
for their own print jobs. 


Viewing Print Job Information 


You can view information about individual print jobs waiting to be processed by a specific printer 
by using the following procedure. 


1 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer the job was sent to. 
3 Click Printer Control > Jobs. 


Information about the print jobs is displayed. 


Deleting Print Jobs 


Administrators can delete any print job after it has been submitted if the job has not yet started 
printing. Users can delete only their own print jobs. 


You can delete a print job from the jobs list by using the following procedure. 
4 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer the job was sent to. 
3 Click Printer Control > Jobs. 
4 Check the check box next to the job you want to delete. 
5 Click delete. 
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Changing the Order of Print Jobs 


Occasionally, you might need to print a job sooner than other jobs that have already been submitted 
to a printer and are awaiting servicing. Administrators can move jobs up or down the list. Users 
can move jobs only down the list. 


Administrators can reorder any print job after it has been submitted if the job has not yet started 
printing. Users can reorder only their own print jobs. 


The following procedure explains how this is done. 
1 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer the job was sent to. 
3 Click Printer Control > Jobs. 
4 Check the check box next to the job you want to modify. 


5 Click Promote to move a print job up the list. 


Moving Print Jobs 


You can allow operators and job owners to copy or move a print job to another printer. The target 
printer must be running on the same server (managed by the same Print Manager) as the printer on 
which the job currently resides. Also, the target printer must be compatible with the driver that 
formatted the job. For example, if a job was formatted with an HP5si driver, it should not be copied 
or moved to an HP LaserJet* III. 


Administrators can copy or move any print job after it has been submitted if the job has not yet 
started printing. Users can copy or move only for their own print jobs. 


To move a print job using Novell iManager: 
1 In Novell iManager, click Print > Manage Printer. 
2 Browse to and select the printer the job was sent to. 
3 Click Printer Control > Jobs. 
4 Check the check box next to the job you want to move. 


5 Click Move to move the print job to another printer in the list. 


Modifying Print Job Characteristics 


You can modify a print job in two ways: 
+ Use printer driver profile 


To set the defaults for a printer driver so that the same defaults are installed every time a 
printer is installed, create printer driver profiles. This is the recommended method. For more 
information, see “Using Printer Driver Profiles” on page 56. 


+ Modify the specific job 


When a job is submitted, it inherits the properties of the installed printer's configuration. The 
configuration of the job can then be modified, if needed, by the job's owner or the printer's 
Operator. 


When jobs are modified, additional configurable properties are available which are not 
included in the original printer configuration. For example, the job can be delayed and 
advanced attributes can be viewed and modified. 
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Administrators can modify any print job after it has been submitted if the job has not yet started 
printing. Users can modify only their own print jobs. 


To modify a job: 
4 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer the job was sent to. 
3 Click Printer Control > Jobs. 
If you want to see a list of jobs already processed and being retained, click Retained Jobs. 


Information about each print jobs is displayed. 


Using Printer Driver Profiles 


Printer driver profiles let you set the driver defaults for a printer driver. Then you associate the 
printer driver profile to a printer so that when the printer is installed, it is configured with the 
settings you want. 


For example, in a law office you might want the default paper size to be 8-1/2 x 14. This means 
every time the printer and corresponding driver are installed on a workstation, the paper size is set 
to 8-1/2 x 14. 


Create, Modify and Delete Printer Driver Profiles 


When creating a printer driver profile, you work directly with a platform-specific printer driver; 
therefore, you must create and modify profiles from the same operating-specific platform as the 
printer driver. For example, if you wanted to create or modify a Windows 2000 printer driver 
profile, you must access iManager and complete the task from a Windows 2000 workstation. 


1 In Novell iManager, click ¡Print > Printer Driver Profile. 


2 Browse to and select the Print Manager where you want the driver profile stored and made 
available to the printers on that manager. 


3 Select an operation and click OK. 
+ Create Printer Driver Profile: Creates a new printer driver profile. 
+ Delete Printer Driver Profile: Deletes an existing driver profile. 
+ Modify Printer Driver Profile: Edits the settings of an existing printer driver profile. 


After creating a printer driver profile, you need to associate it with a printer. 


Associate a Printer Driver Profile with a Printer 

1 In Novell iManager, click ¡Print > Manage Printer. 
Browse to and select the printer you want to modify. 
Click Drivers > printer_driver_operating_system. 


Select the printer driver from the list of Available Drivers. 


a A WO N 


Select the profile you want associated with this printer from the list of Available Driver 
Profiles for Selected Driver. 


If you do not want a profile associated, select None. 


6 Click OK to save the changes. 
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Using Printer Banner Pages 


Banner pages create a cover sheet for each print job that a printer produces. Using the Printer 
Banner Configuration task, you can customize the information printed on a banner to your needs. 


NOTE: If you are using banners under Manage Printer > Configuration > Defaults (Legacy), we recommend 
that you transition to using custom banners. If you continue to use a legacy banner and specify a custom 
banner, both banners will print with each print job. Custom banners is the preferred method for implementing 
banners because it provides a more consistent and reliable mechanism 
Configure a Custom Banner 
1 In Novell iManager, click ¡Print >Printer Banner Configuration. 
2 Browse to and select the Print Manager you want. 
3 Select an Operation. 
Create Custom Banner: Creates a new custom banner. 
Delete Custom Banner: Deletes an existing banner. 
Modify Custom Banner: Edits an existing custom banner. 
4 Enter a custom banner name. 
You should choose a descriptive name so it is easier to assign the banner later. 
5 Select the Banner Text Location. 


This is where the banner option information appears on the banner page. The banner 
information is grouped together and then placed as a chunk either starting at the top of the 
page, centered on the page, or starting at the bottom of the page. 


6 Select the banner options you want and the font size you want to use to display the 
information. 


7 Click OK to save the changes. 


Associate a Custom Banner to a Printer 
1 In Novell iManager, click ¡Print > Printer Banner Configuration. 


2 Browse to and select the Print Manager where the printer agents are hosted. 


oo 


Select Assign Custom Banner, then click OK. 


A 


From the Custom Banner drop-down list, select the banner you want. 


al 


Check the check box next to each printer you want this banner associated with. 


When you check the check box, the banner name will appear in the Assign Banner field. To 
associate a different banner, select the desired banner from the Custom Banner drop-down list, 
and check the check box for the printer you want to change. If you do not want a banner to be 
used, select None. 


You can also assign banners when using the Manage Printer task. 
4 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer you want to modify. 
3 Click Configuration > Custom Banners. 


4 In Available Banners, select the banner that you want this printer to use. 
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5 Click OK to save the changes. 


NOTE: If you are using banners under Manage Printer > Configuration > Defaults (Legacy), we recommend 
that you transition to using custom banners. If you continue to use a legacy banner and specify a custom 
banner, both banners will print with each print job. Custom banners is the preferred method for implementing 
banners because it provides a more consistent and reliable mechanism 


Modifying the Printer’s Gateway Load Commands 


You can modify the Printer’s gateway load commands by using iManager. 
4 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer you want to modify. 
3 Click Configuration > Gateway. 


4 Edit the gateway autoload command. 


Table 1 Gateway Load Parameters 

Parameter Description 

NDPSGW The gateway NLM™ that is loaded for this 
printer agent. 

PA= The printer agent name that is to be loaded. 

PORT=LPR port_specific_parameters The type of port to be used. Supported values 
are LPR and NULL. The port value is followed 
by port-specific parameters. See Table 2 on 
page 58. 

HOST= or HOSTADDRESS= The hostname (DNS Name) or IP address of 
the printer. 

PRINTERNAME= Passthrough is used for most printers. If you 
are printing to a UNIX printer, use a UNIX-type 
printer or queue name. 

GETCOMMUNITYSTRING= Specifies the community string to be used for 
SNMP Get and GetNext requests. 

NOQUERY Prevents initialization queries on the server. 


This parameter is optional. 


Table 2 Port-Specific Parameters 
Parameter Description 


T= and R= Used to set the timing to re-establish a 
connection if communication with the printer is 
lost. You should leave this at the default of 
T=90 and R=60. 
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Parameter Description 


SPOLL= The base SNMP polling interval (in seconds). 


Only select SNMP information, like the printer’s 
alert table and display console, is gathered at 
this polling interval. 


Other information that changes less frequently, 
like the level of paper in a paper tray or the 
amount of toner is gathered about every four 
polling intervals; additional printer information, 
like printer memory, is gathered every 10 
polling intervals. 


5 Click OK to save the changes. 


Configuring Printer Settings 


IMPORTANT: While you can configure the settings in this section on a per-printer basis, we recommend that 
you use Printer Driver Profiles and Custom Banners for iPrint and new NDPS printers. The printer configuration 
defaults should be used only for existing NDPS printers that already use these settings. 


To modify the default settings: 


1 In Novell iManager, click ¡Print > Manage Printer. 


2 Browse to and select the printer you want to modify. 


3 Click Configuration > Defaults (Legacy). 


4 Modify the settings. 


+ 


Copies: The number of copies that will be printed for this configuration. 
Max Copies: The maximum number of copies that a user can print using this printer. 
Priority: The priority assigned to jobs using this configuration. 


Max Priority: The maximum priority (Low, Medium, High) set by the administrator for 
jobs using this printer. This setting determines when the job will print in relation to other 
jobs with different priorities sent to this printer. 


Banner: A list of banner pages users can select from. Banner pages will be printed at the 
beginning of print jobs using the configuration. If multiple copies of a document are 
printed, the banner page will be printed only at the beginning of the first copy. 


TIP: If your client, printer, and server are not all configured for the same language, you might 
experience problems with the output of your banner pages, such as the job name being corrupted. 
If you are working in this type of mixed environment, you should consider not using banner pages. 


Ifyou check the check box to lock the current setting, users will not be able to change this 
setting on the printer. 


Medium: The medium (form) on which jobs can be printed without stopping the printer 
to mount a different medium (form). The default on the printer is Any Medium, which 
allows jobs to be printed using the currently mounted medium regardless of media 
specified in the job data. If a medium is specified for this configuration and a different 
medium (anything other than Any Medium) is mounted on the printer, this condition 
causes the printer to pause for the given amount of time (default is 15 minutes) or until 
the new media is mounted. If this Job Wait Time expires, the job is placed on hold and 
returned to the spooling area. 
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If you check the check box to Lock the current setting, users will not be able to change 
this setting on the printer. 


5 Click OK to save the changes. 


Configuring Job Holds 
1 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer you want to modify. 
3 Click Configuration > Job Holds. 
4 Modify the settings. 
+ Operator Hold. Jobs do not print until the Operator releases them. 
+ User Hold. Jobs do not print until the user who submitted the job releases it. 


+ Retain Job No Longer Than. The maximum amount of time that jobs to this printer can 
be retained after printing before being deleted (Minutes, Hours, Days, Years). By default, 
jobs are not retained. 


+ Retain Job For. The amount of time that a job sent to this printer should be retained 
(regardless of when it is printed) until it is deleted (Minutes, Hours, Days, Years). 


5 Click OK to save the changes. 


Optimizing Event Notification 


In NetWare Administrator, you can configure event notification for users who want to be notified 
of a defined printer or server event that occurs during the processing and printing of a job. 


For example, the administrator for a specific printer (by default a Manager of that printer) can 
designate an Operator to be notified if the printer runs out of paper or if the toner is low. 


Notification Types 


In NetWare Administrator, administrators can configure two types of event notification: 


+ Job-owner notification. You can configure event notification for job owners only through the 
printer's Configuration dialog box. When notification is part of a configuration, the owner of 
a job submitted to a printer with that configuration will receive the notification specified. For 
more information, see “Configuring Job-Owner Notification” on page 61. 


At the workstation, individual users can use the Novell Printer Manager to configure event 
notification pertaining to their own jobs. 


+ Interested-party notification. You can use the Access Control Notification feature to 
configure notification to be sent to a printer's Managers, Operators, or other interested parties 
about specified events, normally those that require intervention of some kind. 


Because this feature is tied to the Printer Access Control feature, it allows you to restrict the 
list of individuals who will be receiving this notification as much as you want. For more 
information, see “Configuring Interested-Party Notification” on page 61. 


Delivery Methods 


The availability of the following delivery options are dependent on which of them you have 
enabled. See “Enabling Event Notification Delivery Methods” on page 67 for more information. 
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+ Pop-up notification. Messages will pop up on the screen of individuals designated to receive 
them. Users designated for pop-up notification must have a default server defined in their User 
Environment specified in NetWare Administrator. They also must be currently authenticated 
to that server or they will not receive notification. 


+ SMTP notification. Messages will be sent to the recipient through SMTP (Simple Mail 
Transfer Protocol) in IP-based systems. 


¢ Log file notification. Messages are written to a file at a designated location on a NetWare 
server that the recipient has rights to. This is especially useful for keeping a record of printing 
events for auditing purposes (such as job completions, how often the toner ran out, etc.). 


+ Programmatic notification methods. Two programmatic notification delivery methods are 
shipped: SPX™ and RPC. 


¢ Third-party notification methods. The open architecture of the print system allows third 


parties to develop additional delivery methods. 


Configuring Job-Owner Notification 


Job-owner notification can be configured for specific print jobs or for printer configurations. This 
section provides procedures for each method. 


Notification for Specific Print Jobs 
Configuring notification for a specific print job can be done as follows. 
4 From the main Printer Control view of the printer's Details page, click Jobs/Job List. 


2 (Conditional) If you want to see a list of jobs being retained and not currently scheduled for 
processing, click Show Retained Jobs. 


3 Click Job Options and select Configurations from the drop-down list. 
4 Click Notification. 
5 Select the notification methods and events you want. 


6 Click OK. 


Configuring Interested-Party Notification 


The following procedure allows you to specify the users who will receive event notification for a 
Printer object, the method of notification, and the types of events they will receive notification for. 


1 In NetWare Administrator, select the Printer you want to configure. 
2 Click the Access Control button. 
Three roles are available: Manager, Operator, and User. 
3 Select the role you want to configure Access Control notification for. 
4 Select the object you want to configure notification for and click Notification. 
5 Click the icon representing the method you want to use. 
6 Select the notification methods and events you want. 


7 Click OK. 
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Setting Print Job Spooling 


Although you do not need to send print jobs through queues, jobs submitted to printers will often 
need to be stored somewhere when the printer is already processing other jobs or when the job is 
on hold or retain status. Job spooling allows you to specify where you want jobs to be stored while 
they await processing. 


By default, the spooling area for a printer is located on the same volume as the database for the 
Print Manager supporting that printer. However, the Spooling Configuration option allows you to 
spool jobs to a different location through the following procedure. 


Job spooling offers greater simplicity and management convenience than queue-based printing. 
Spooling requires only that a directory be designated where jobs can be stored while awaiting 
processing. 


You can modify job spooling at any time, even when a job is already being processed. 


The following procedure explains how to optimize job spooling: 
1 In Novell iManager, click ¡Print > Manage Printer. 
2 Browse to and select the printer you want to enable Access Control for. 
3 Click Configuration > Spooling. 
4 Modify the spooling information. 


Spooling Location: Specify the path where print job data will be stored while waiting to be 
printed. By default, the spooling area for a printer will be located in the same volume as the 
database for the Print Manager supporting that printer. 


Available Disk Space: The amount of disk space available on the volume. 


Limit Disk Space: To limit the amount of disk space to be used for spooling, check the check 
box and set the limits you want. 


Spooling Space: The total amount of disk space in kilobytes (KB) you want to set aside for 
print job spooling. 


Retained Job Space: The amount of disk space in kilobytes (KB) you want to set aside for 
holding retained print jobs. This amount should be sufficiently less than the total spooling 
space to ensure that new print jobs can be processed efficiently. 


There are four common job scheduling algorithms available: First In, First Out, Print Smallest 
Job First, Minimize Media Changes, Backward Print Only Current Medium. 


5 Click OK. 


Supporting Queue-Based Client Workstations 
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If your network includes clients like Macintosh and OS/2 that are not able to send jobs to Printer 
Agents directly, the backward compatibility of the Novell print system allows these clients to 
submit jobs to the same queues they always have. Then the Printer Agent can retrieve jobs from 
these queues and print them. 


To set up a printer to service legacy queues: 
4 In Novell ¡Manager click ¡Print > Manage Printer. 
2 Browse to and select the printer you want. 


3 Click Client Support > QMS Support. 
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4 Modify (add to/delete from) the Service Jobs from NetWare Queues list. 
5 Click OK or Apply to save the settings. 


Managing the Broker 


Although the default settings allow your users to print without further configuration being 
necessary, you will probably want to modify some settings so that you can manage your printing 
resources most effectively. 


This section discusses the following: 
+ Accessing the Broker Health Monitor (page 63) 
+ Adding or Updating Brokered Resources (page 63) 
+ Changing the Location of a Broker (page 64) 
+ Adding Banner Pages (page 64) 
+ Adding or Updating Printer Drivers (page 66) 
+ Enabling Event Notification Delivery Methods (page 67) 
+ Enabling and Disabling Brokered Services (page 68) 
+ Reconfiguring a Broker (page 68) 
+ Broker Startup Switches (page 69) 


Accessing the Broker Health Monitor 


You can use the Broker Health Monitor to monitor and view statistics about the brokered services. 
To access the Health Monitor from NetWare Remote Manager, complete the following 


1 User your Web browser to log on to NetWare Remote Manager at https:// 
server_ip_address:8009. 


2 Under Diagnose Server, click NDPS Broker Health. 


Adding or Updating Brokered Resources 


The following procedure explains how to add banner pages, printer drivers, and printer definition 
(NPD) files to the resource database available through a Broker's Resource Management Service. 


Resources cannot be installed from multiple diskettes. If a printer driver or other resource is 
shipped on more than one diskette, copy the files to a directory on a hard disk or network drive and 
install it from there. 


To add new resources through the Resource Management Service, do the following. 


1 Make sure the Resource Management Service is enabled either in Novell ¡Manager or by 
going to your server console and viewing the Broker status page. 


2 In Novell iManager, click Manage Broker and then browse to and select the Broker you want 
to work with. 


3 Click Resource Management Service and then the resource you want to work with. 
4 Add or delete resources. 


5 Click OK. 
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Changing the Location of a Broker 


You can customize your printing setup for maximum efficiency. You might occasionally want to 
change the location of one or more Brokers. For example, you might want a Broker to be in a 
different eDirectory container. If you want to change the location of a Broker after 1t has been 
created, you can use NetWare Administrator to move the Broker object into the desired container, 
provided you have Supervisor or equivalent rights to the new container. 


Adding Banner Pages 


IMPORTANT: Beginning with NetWare 6.5 Support Pack 2, we recommend that you transition to using the 
Printer Banner Configuration task in iManager. Although, you can still use the banner pages as discussed in 
this section, the Printer Banner Configuration task provides reliable and consistent banners that should be 
flexible enough to meet your organizations needs without requiring you to create a separate banner file. For 
more information, see “Using Printer Banner Pages” on page 57. 


Banner pages are pages that are printed at the beginning of a print job and that normally contain 
job identification information. Banner pages can be configured for PostScript*, PCL*, and text 
formats. 


There are a variety of options for creating and selecting banner page designs. You can choose from 
several ready-to-use banner page designs, or you might create a unique design that includes your 
company's logo, a drawing, or even a photograph. 


When you add a new banner, it will be immediately available for printer configurations. If you 
want a banner page to be printed, you can select which banner design you want to use at the 
General tab on the Configuration page. The Configuration page lists only banners available in the 
format your printer supports. For example, if you are using a PostScript printer, only banners in 
PostScript format will be available at the General configuration page. 


Each banner page includes the following information in an information box at the bottom of the 
page: Job Name, Job Owner, Time Printed, Date Printed. 


If your client, printer, and server are not all configured for the same language, you might 
experience problems with the output of your banner pages, such as the job name being corrupted. 
If you are working in this type of mixed environment, you should consider not using banner pages. 


Banners are added to the resource database through the Broker's Resource Management Service. 


See the following topics for information about specific tasks associated with using banners. 


Adding Banners to the Resource Management Service 


1 Make sure the Resource Management Service is enabled either in Novell ¡Manager or by 
going to your server console and viewing the Broker status page. 


2 In Novell iManager, click Manage Broker and then browse to and select the Broker you want 
to work with. 


3 Click Resource Management Service > Banners. 
4 Add or delete banners. 
5 Click OK. 


What Printer Types Support What Kind of Banner 


A list of supported banners is supplied by both the Novell Gateway (through the PDS) and third- 
party gateways. The gateway first determines which file extension (.pcl, .ps, or .txt) is appropriate 
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for the way the Printer object (or Printer Agent) was configured during creation. It then queries the 
associated Broker for a list of banner page files with that extension. For a list of formats supported 
by a specific printer, go to the main Printer Details page and click the Features button. 


Creating Banner Files 


Administrators with knowledge of printer languages can create custom banners. Three types of 
custom banners are currently supported: 


+ PCL (.pcl extension). See “Creating a PCL Banner” on page 65. 
+ PostScript (.ps extension). See “Creating a PostScript Banner” on page 66. 


+ Generic text (.txt extension). See “Creating a Generic Text File” on page 66. 


All custom banners that are created should have one of these extensions. When creating custom 
banners, keep in mind that complex banners will increase the print time for jobs. Here are some 
tips for creating an efficient banner: 


+ Use internal/resident printer fonts instead of rasterized system fonts. 
+ When using graphics, use vector graphics when possible. Bitmaps take up a lot more space. 


+ Avoid halftone images. 


Creating a PCL Banner 


A working knowledge of the Hewlett Packard* (HP*) PCL printer language is needed in order to 
create a custom PCL banner. The easiest way to create a PCL banner is to create the banner using 
an application like WordPerfect or MS Write. Be sure to leave the lower third of the custom banner 
page blank because the print system will overlay the following information in a PCL banner page: 


Job Name 
Job Owner 
Time Printed 
Date Printed 


1 After formatting the banner page, print the banner document to a file using the appropriate 
PCL printer definition. 


The driver properties need to be changed from printing to a port/network to printing to a file 
on disk. All PCL banners must have the .pcl extension. 


2 Remove the form feed and reset commands in the file that was printed to disk. 


You will need a binary editor to remove the form feed and any reset commands from the file. 
The form feed and reset commands will be in the overlay that the print system provides. A 
form feed in PCL is a decimal 12 (hex 0C). There are several possible reset commands that 
need to be removed. Decimal 27, 69 (hex 1B,45) is the printer reset in PCL. The following 
Universal Exit Command (UEL) also needs to be removed: 


Decimal 27,37,45,49,50,51,52, 53, 88 

(Hex 1B,25,2D, 31,32, 33,34,35,58) 

After the form feed and reset are removed, you have a banner file that can be used. 
3 Add the banner to the Resource Management Service. 


See “Adding or Updating Brokered Resources” on page 63 for more information. 
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Creating a PostScript Banner 


A working knowledge of the Adobe* PostScript printer definition language is needed in order to 
create a custom PostScript banner. The easiest way to create a PostScript banner is to create the 
banner using an application like WordPerfect or MS Write. Be sure to leave the lower third of the 
custom banner page blank because the print system will overlay the following information in a .ps 
banner page: 

Job Name 

Job Owner 

Time Printed 

Date Printed 


1 After formatting the banner page, print the banner document to a file using the appropriate 
PostScript printer definition. 


The driver properties need to be changed from printing to a port/network to printing to a file 
on disk. All PostScript banners must have the .ps extension. 


2 Using a text editor, remove the PostScript operator named showpage from the file that was 
printed to disk. 


The driver will probably have a procedure that includes the showpage command. (The 
showpage command will be in the overlay.) Sometimes showpage is embedded in another 
function within the driver and you must use care in removing it. 


3 Add the banner to the Resource Management Service. 


See “Adding or Updating Brokered Resources” on page 63 for more information. 


Creating a Generic Text File 


A generic text banner must have a .txt extension. The banner can be formatted in any printer 
language. The print system will not overlay any additional information on this banner page. 


Adding or Updating Printer Drivers 
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A printer driver is a software entity that directly supports a physical printer, enabling it to carry out 
the functions it is intended to perform. 


Hardware vendors develop printer drivers, which are specific to each printer. Most printers require 
different printer drivers for each operating system they interact with. You can view a complete list 
of printer drivers currently loaded in the Broker's Resource Management Service (RMS) for 
Windows, and to add additional printer drivers from diskettes and Windows .cab files. 


The print system ships with only English-language drivers. To make drivers in other languages 
available for installation on workstations, you will first need to add those drivers to the RMS 
through the procedure described in this section. 


While the majority of printer drivers in common use today can be used, some cannot. A few drivers 
do not work on a network at all, while others might not contain an index file or have an index file 
that is incorrectly formatted. If you attempt to add a printer driver to the Resource Management 
Service from a diskette and receive an error message stating that a printer driver cannot be found, 
you should contact the driver's vendor. 
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Prerequisite 


Printer drivers cannot be installed to the Resource Management Service from multiple floppy 
disks. If a printer driver is shipped on more than one disk, copy the files to a directory on a hard 
drive or network drive and install the driver from there. 


Procedure 


1 Make sure the Resource Management Service is enabled either in Novell ¡Manager or by 
going to your server console and viewing the Broker status page. 


2 In Novell iManager, click Manage Broker and then browse to and select the Broker you want. 
3 Click Resource Management Service and then the type of printer driver you want to add. 
4 Click Add From File to add drivers from a printer driver .inf file 

OR 


Add From System to add drivers from the workstation you are running ¡Manager from. The 
drivers installed on your workstation are made available for upload to the Broker. You can 
only upload drivers to the same platform as the workstation. 


5 Click OK or Apply to save your changes to the database. 
The drivers will not be added to the database until you do this. 


The process described above might not work if the driver installation .inf file uses subdirectory 
paths in filename designations within the Copy Files sections of the .inf file. This format is not 
currently supported. There are two possible solutions for this problem: 


+ Look for an .inf file that does not use this format for filenames. Often one exists in a 
subdirectory of the installation disk. 


¢ Edit the .inf file and remove path information from filenames. Then ensure that all the files 
are in the same directory as the .inf file. 


Enabling Event Notification Delivery Methods 


The Broker provides an Event Notification Service (ENS) that allows printers to send customized 
notifications to users and operators about printer events and print job status. ENS supports a 
variety of delivery methods, including pop-up messages, log files, e-mail and programmatic. Third 
parties can also develop additional methods. 


The Event Notification Service allows you to enable delivery methods such as e-mail and third- 
party methods not provided directly. The executable files for these methods have an .enm 
extension (filename.enm) and must be added to the server\sys:system directory or another location 
in the server's search path. 


For more information about Event Notification, see “Enabling and Disabling Brokered Services” 
on page 68. 


1 Besure the Event Notification Service is enabled by going to your server console and viewing 
the Broker status page. 


2 In Novell iManager, click Manage Broker and then browse to and select the Broker you want. 
3 Select the Event Notification view. 


4 Click the Load or Unload button. 
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WARNING: Do not unload the RPC and SPX™ Programmatic Notification methods. These are needed 
for communication between printers and the workstation Printer Manager utility to occur and for driver 
download to take place. 


5 Specify the ENM filename for the notification method you want to load. 


This ENM must be in your server\sys:system directory or in another location in your server's 
search path in order to be loaded. 


The Broker object will load this notification method automatically in the future. 


Enabling and Disabling Brokered Services 


When the print system is initially installed, the three network services provided by the Broker are 
automatically enabled on the Broker object. As your printing needs grow or change and you add 
additional Brokers to your network, you might want to disable certain services provided through 
a Broker on a specific server and allow them to be provided through a different Broker (to save 
disk space on the first server, for example), or you might want to enable services on a Broker that 
are currently disabled. This procedure explains how these tasks are performed. 


1 In Novell iManager, click ¡Print > Manage Broker. 
2 Browse to and select the Broker you want. 
3 On the Broker Control tab, deselect the Broker services you want to disable. 
To enable a service, select that service’s check box. 
4 Click OK. 
Printer Agents using the services that were disabled will automatically search for another Broker 


on the network that will provide these services, so normally these printers should continue to be 
available for processing jobs. 


However, if you want to specify a preferred Broker for a Printer Agent to use for these services, 
you must do this from each printer's Printer Control page in NetWare Administrator by selecting 
Features/Services. 


If a Broker is unloaded and then is brought back up, Printer Agents that have designated that 
Broker as their preferred service provider will not be automatically reconnected to it. In order to 
reconnect to the preferred service provider, you must either unload each Printer Agent and bring 
it back up, or unload the Print Manager that controls the affected Printer Agents and bring it back 
up, thus bringing up all the Printer Agents with it. 


If the Resource Management Service cannot be enabled, check for one of the following problems: 


+ The Broker object does not have rights to access the RMS data storage area (the default is 
ndps\resdir\). Use NetWare Administrator to grant the Supervisor right to the Broker for that 
subdirectory. 


+ The RMS data storage area has a directory name that is longer than eight characters or 
includes invalid characters. 


Reconfiguring a Broker 
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In most instances, the default configuration for the three support services it provides will result in 
satisfactory performance. However, in certain circumstances you might want to change that 
configuration. Here are a couple of examples: 
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+ As you gain experience with your print system setup, you might want to reconfigure the 
default properties assigned to the Broker. 


+ If disk space on your volume is limited, you might want to move the managed resources 
database accessed by the Resource Management Service to a different volume on the same 
server or to a different server in the same eDirectory tree where more disk space is available. 
(The default location for the RMS resources is server\sys:ndps\resdir\) 


Prerequisites 


+ To reconfigure a Broker, you should have Supervisor rights for the container where the Broker 
resides. 


¢ Ifyou change the location of your Resource Management Service database, you need to have 
rights to the new location. 


¢ Ifyou change the location of your Resource Management Service database, you need to have 
an existing Resource Management Service database directory to point to when you specify the 
volume for the RMS during this process. The path you specify must point to a directory that 
currently exists and that already contains resources. (The RMS data storage area must not 
have a directory name that is longer than eight characters or includes invalid characters.) If 
you point to an empty directory, you will receive an error message from the server when 
loading the Broker saying that the Broker cannot be enabled. (You can copy resources from 
another RMS to this directory if you want.) 


Procedure 


The following procedure explains how to reconfigure an existing Broker object or move your 
brokered resources to a different location. 


1 In NetWare Administrator, select the Broker object you want to reconfigure. 
2 Ifyou want to change the location of your resources, complete the following: 
2a Click Resource Management. 
2b Enter in the resource path you want to use for storing these resources. 
You might need to assign the Broker all rights (Supervisor right) to the new area. 


3 Ifyou want to modify the Access Control list, click Access Control and add or remove users 
from the Managers list. 


See “Managing the Broker” on page 63 for more information. 

4 If you want to enable or disable your Service Registry, click Service Registry Service. 
See “Enabling and Disabling Brokered Services” on page 68 for more information. 

5 If you want to load or unload Notification methods, click Event Notification. 


See “Enabling Event Notification Delivery Methods” on page 67 for more information. 


Broker Startup Switches 


To always load a Broker with the same startup switch, add the switch to the load Broker entry in 
the server’s autoexec.ncf 


Syntax: 


load broker broker_name_and_context /startup_parameter 
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Example: 
load broker .sales_manager.corp.acme /dbvolume=sales_sys 


The following table lists the startup switches you can use when loading broker.nlm. 


Startup Parameter Description 

noui Loads the Broker without displaying the user 
interface. 

noipx The Print Manager will not support the IPX™ 
protocol. 

noip The Print Manager will not support the IP protocol. 

allowdup The NLM™ will not check for two Brokers using the 


same Broker object. 
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Setting Up a Secure Printing Environment 


Setting up a secure printing environment can be done on three different levels. 


+ Access Control lets you assign users to a User, Operator, or Manager role to control printers, 
Print Managers, and Brokers. 


+ Printer Security defines how rights to a printer are determined and enforced. 


+ Using SSL with ¡Print requires users to authenticate before installing and printing to a printer. 


Setting Access Control for Your Print System 


Your print system is designed to take full advantage of eDirectory™. You receive all the benefits 
of eDirectory security and the easy management provided by the industry's most advanced and 
robust directory service. The Access Control feature allows you to specify the access each User, 
Group, or container object must your printing resources. 


Access control roles are mutually exclusive, even though the same individual might need to 
perform tasks reserved for different roles. For example, only printer Managers can add or delete 
printer Operators or printer Users. In a similar way, Managers and Operators must also be 
designated as Users for a printer before they can submit print jobs to it. 


In actual implementation, the defaults prevent most problems that might occur from these 
distinctions. For example, a Manager is automatically designated an Operator and User as well, 
while an Operator of a printer is automatically designated a User of that printer also. You cannot 
remove the User role from an Operator, and you cannot remove the Operator and User roles from 
a Manager. 


The creator of an object is automatically granted privileges for all available roles for the type of 
object being created. 


The following sections illustrate some of the security issues and features you might find useful as 
you plan your print system setup: 


¢ “Setting Access Control for Printers” on page 71 
+ “Setting Access Control for the Print Manager” on page 74 


+ “Setting Access Control for Brokers” on page 74 


Setting Access Control for Printers 


Printer security is ensured through the assignment of the Manager, Operator, and User access 
control roles and by the strategic placement of your printers and printer configurations. 


You can assign multiple Printer objects to represent a single Printer Agent. You can then make 
different access control assignments to each Printer object. This can be an especially useful option 
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if you want to allow users in different containers to use the same printer, because each group of 
users can be given different rights to the printer. 


A physical printer cannot be a controlled access printer and a public access printer at the same 
time. However, if you delete all the Printer objects representing a Printer Agent, that printer 
becomes a public access printer. 


IMPORTANT: We recommend that you do not use public access printers because you lose 
management capabilities. Using controlled access printers lets you manage printers through 
iManager, use the printer with iPrint, and take advantage of advanced ¡Print features like 
downloading printer drivers. 


The following sections discuss security options for printers in more detail: 
+ “Printer Access Control Roles” on page 72 
+ “Assigning Printer Access Control Roles through Printer Objects” on page 73 
+ “Assigning Printer Access Control Roles through User Objects” on page 73 


+ “Planning Your Printer Connections and Locations for Better Security” on page 73 


Printer Access Control Roles 
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Different User, Group, or Container objects can have different access rights to the same printer. 
For example, if you want only certain users to be able to send jobs to a particular printer, you can 
specify which users should have access and what access roles each will have. 


The following table describes the rights and privileges associated with each of the printer access 
control roles. 


Role Description 


Manager Tasks performed exclusively by the Printer Manager are those that require the 
creation, modification, or deletion of Printer objects, as well as other 
eDirectory administrative functions. Printer Managers are automatically 
designated as printer Operators and Users as well, so they can perform all 
tasks assigned to those roles. Typical Manager functions include the 
following: 


+ Modifying and deleting Printer objects 

+ Adding or deleting Operators and Users for a printer 
+ Adding other Managers 

+ Configuring interested-party notification 


+ Creating, modifying, or deleting printer configurations 


Operator Printer management tasks performed by the Operator include the following: 
+ Performing all of the functions available through the Printer Control page 
+ Pausing, restarting, or reinitializing printers 
+ Reordering, moving, copying, and deleting jobs 
+ Setting printer defaults, including locked properties 
+ Configuring print job spooling 


Operators cannot create, modify, or delete eDirectory objects or perform other 
eDirectory administrative functions. 
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Role Description 


User Tasks performed by Users include the following: 


+ Submitting print jobs 


+ Managing print jobs they own (Users cannot copy, move, reorder, or 
remove jobs they do not own) 


To simplify administration, the container a printer resides in is automatically 
assigned as a User for that printer, so all users in that container and its 
subcontainers can use that printer without being added to the list. You can 
delete the container from the list if you want to limit access to certain users, 
groups, or roles. 


Assigning Printer Access Control Roles through Printer Objects 


Different User, Group, or container objects can have different access rights to the same printer. For 
example, if you want only certain users to be able to send jobs to a particular printer, you can 
specify which users should have access and what access roles each will be given. 


1 
2 
3 
4 
5 


In Novell iManager, click ¡Print > Manage Printer. 

Browse to and select the printer you want to enable Access Control for. 

Click the Access Control tab. 

Add or delete Users, Groups, or Container objects to the different access control roles. 


Click OK. 


Assigning Printer Access Control Roles through User Objects 


In addition to configuring access control through printers, you can also configure access control 
through User objects. 


The following procedure assumes that you are modifying the attributes for an existing User. You 
can also adapt this procedure if you are creating a new User object. 


1 


4 
5 


From the NetWare Administrator browser's Object menu, select the User object you want to 
configure access control for, and then click Printer Access Control. 


A list of available printers is displayed with icon representations of the three Access Control 
roles: User, Operator, and Manager. 


Select the printer that you want to assign this user an access control role for. 
Check the roles you want this user to be assigned for this printer. 


If you check Manager, this user is automatically assigned Operator and User roles as well. 
Operator and User roles are assigned independently. Keep in mind that a User object must be 
assigned the access control role of User in order to submit print jobs to that printer. 


(Optional) Click the Event Notification button to configure event notification for this user. 


Click OK. 


Planning Your Printer Connections and Locations for Better Security 


Depending on your organization's needs, the network administrator can attach printers directly to 
NetWare® servers or to the network. Both types of setup can provide security and administrative 
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advantages. The ideal combination for each installation is different and will change as needs 
change. Be sure to consider the advantages of each approach when you set up your network. 


Connecting the printer to the server places the two resources in close proximity to each other. If 
the server is in a secure location, this means that the printer is locked up with the server. This might 
be an advantage. For example, your company might use that printer to print confidential 
documents. Having the printer in a secure location protects these documents. 


Because most printers are already network-enabled, the most common type of network setup 
includes printers attached directly to the network. This allows the printer to be placed in a 
convenient location for all users, and places it away from the server for security reasons. Users 
who use the printer normally will not have access to the server console. Security is still maintained 
by requiring users to use a password to log in to the network before they can use the printer. 


Setting Access Control for the Print Manager 


Print Manager security is ensured through the assignment of the Manager access control role. 


Print Manager Access Control Role 


The only access control role available for the Print Manager is that of Manager. The following 
table explains the tasks performed by the Manager role. 


Role Description 


Manager Tasks performed exclusively by the Manager are those that require the 
creation, modification, or deletion of eDirectory objects, or that involve other 
eDirectory administrative functions. Typical Manager functions include the 
following: 


¢ Creating printer agents and Print Manager objects 

+ Adding or deleting Operators and Users for a printer 
+ Adding other Managers 

+ Configuring interested-party notification 


+ Creating, modifying, or deleting printer configurations 


Assigning the Manager Role for Print Managers 


The following procedure explains how to make Manager assignments for your Print Manager 
objects. 


1 In Novell iManager, click ¡Print > Manage Print Manager. 

2 Browse to and select the Print Manager you want to enable access control for. 
3 Click the Access Control tab. 

4 Add or delete Users, Groups, or Containers to the Manager role. 


5 Click OK 


Setting Access Control for Brokers 


Broker security is ensured through the assignment of the Manager access control role and by the 
optional assignment of a password to the Broker. 
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Broker Access Control Roles 


The access control roles available to the Broker are Manager and Public Access User. The 
following table explains the roles 


Role Description 


Manager Tasks performed exclusively by the Broker Manager are those that require the 
creation, modification, or deletion of Broker objects, as well as those that 
involve other eDirectory administrative functions. Typical Manager functions 
include the following: 


+ 


+ 


+ 


+ 


+ 


Creating, modifying, and deleting Broker objects 

Adding other Managers 

Enabling or disabling brokered services 

Adding resources to the Resource Management Service 


Assigning or changing a Broker password 


Public Access User A public access user is a role assigned to all individuals on the network who 
are users of printers receiving services and resources provided by the Broker. 
This role is assigned by default and does not require specific administrative 
action by the Broker Manager. 


Assigning Managers for Brokers 


The following procedure explains how to make Manager assignments for your Broker objects. 


1 In Novell iManager, click ¡Print > Manage Broker. 


2 Browse to and select the Broker you want to enable access control for. 


3 Click the Access Control tab. 


4 Add or delete Users, Groups, or Containers to the Manager role. 


5 Click OK. 


Setting Printer Security Levels 


Printer security levels affect how rights to a printer are determined and enforced. The default 
security level is Medium. With sensitive print data, you might want to set the security level to 
High; however, performance will be affected. 


Printer Security Level Secure Printing Enabled 


Low Security is enforced by the client applications only 


Medium (default) Security is enforced by Print Manager if print data 
integrity is involved. Otherwise, security is enforced by 
the client applications. 


High Security is enforced by the Print Manager for all 
operations. 


To set a printer’s security level, do the following: 
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1 In Novell iManager, click ¡Print > Manage Printer. 

2 Browse to and select the printer you want to enable Access Control for. 
3 Click Access Control > Security. 

4 Select the level of security you want for the printer. 


5 Click OK or Apply to save your changes. 


Secure Printing Using SSL 


Table 3 


Secure printing takes advantage of SSL, which requires users to authenticate using their eDirectory 
usernames and passwords. Users authenticate once per eDirectory tree per session. The print data 
is encrypted, and all print communication uses port 443. Without secure printing, the printer is 
available to anyone inside the firewall on the network and the print data is not encrypted. Secure 
printing works in conjunction with the security level set for the printer. 


The following table shows how access is determined, depending on the level of printer security 
and whether secure printing is enabled or disabled. 


Effects of Printer Security 


Printer Security Level Secure Printing Disabled (No SSL) Secure Printing Enabled (With SSL) 

Low Full access eDirectory authentication 

Medium (Default) Users granted access as if they had eDirectory authentication and check 
been assigned the User role. user’s effective rights 

High Users must use SSL and eDirectory authentication, check 
authenticate to eDirectory user’s effective roles, and 


; ; : _ connection verification 
Users might receive an error if SSL is 


not enabled. (See “High Security SSL is automatically enabled when 
Requires User Authentication” on a printer’s security is changed to 
page 76.) High when using Novell iManager. 


For more information on printer security levels, see “Setting Printer Security Levels” on page 75. 


Considerations When Changing Printer Security 


High Security Requires User Authentication 
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If you change the printer agent security level to high, the Requires SSL and User Authentication 
check box (enabling SSL) on the IPP Support page of the printer’s Client Support Page in Novell® 
iManager is enabled automatically. 


NOTE: When setting printer agent security at the server console, SSL is not enabled automatically, and users 
might receive the following error 


Error message: iPrint Client - "The request requires user authentication." 


To avoid the error, ensure that the Requires Security check box is checked when a printer agent’s security is 
changed to High. For more information, see “Enabling SSL” on page 77. 
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Enabling SSL Changes the Printer URL 


When you check the Requires SSL and User Authentication check box, the URL for the associated 
printer will change. Users who have already installed this printer must delete and reinstall the 
printer in order to use the updated URL. 


Lowering Printer Security 


Once a printer’s security is set to High and SSL is enabled with the Requires SSL and User 
Authentication check box, SSL remains enabled even if the security level is lowered. If SSL is 
disabled, then the URL will change and users must reinstall the printer. 


Enabling SSL Uses LDAP for Authentication 


When you enable SSL or set a printer’s security to High, iPrint uses LDAP to authenticate users. 
When a user authenticates, LDAP begins searching for the user beginning at the root most part of 
the eDirectory tree by default. If this search method becomes an issue, you might want to change 
the starting point for the search to a container closer to the users. The starting point for the search 
can be changed by editing sys:apache2\iprint\ipp.conf and changing the value for the 
AuthLDAPURL parameter. See Apache’s AuthLDAPURL Directive (http://httpd.apache.org/ 
docs-2.1/en/mod/mod_auth_ldap.html) for more information. 


Enabling SSL 


4 In Novell iManager, click ¡Print > Manage Printer. 

2 Browse to and select the Printer object you want to modify. 

3 Click Client Support > iPrint Support. 

4 Check/Uncheck the Requires SSL and User Authentication check box. 
5 Click Apply or OK to update the printer settings. 


Saving Passwords for Secure Printers 


When users print to a secure printer, they are prompted for the eDirectory username and password. 
Users can select to have their workstations remember their password for printing. For Windows 
NT/2000 users, passwords are saved on a per-user basis. 


By default, the Remember Password feature is enabled. To disable it, use a text editor to edit the 
sys:\apache2\htdocs\ippdocs\iprint.ini file to reflect the settings you want. Information on the 
settings is contained in the file. 


IMPORTANT: The iprint.ini file should be synchronized across all servers where ¡Print and a Print Manager 
are running. 
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Configuring the ¡Print HTML Interface 


This appendix discusses the HTML parameters and operations used in the ¡Print interface. This 
information is provided to give administrators insight into how to customize their HTML files. 


Using this information, HTML developers can create and edit ¡Print Web pages to customize them 
for their companies. 


The ¡Print HTML files are located in the sys:\apache2\htdocs\ippdocs directory. 
The following sections will help you customize the HTML interface: 

+ “¡Print Client HTML Interface Description” on page 79 

+ “HTML Parameters” on page 80 

+ “Supported Operation Strings” on page 84 


¡Print Client HTML Interface Description 


The list of operations and identifiers is the same for each browser. The printer name and the 
operation to be performed are required parameters for all operations except “op-client-interface 
version” on page 84 and “op-client-version-info” on page 85. All other parameters are operation- 
specific or optional. Operation-specific parameters that are used out of context are ignored. 


If the desired output from the plug-in is HTML, a frameset needs to be used. This is to prevent 
some browsers from failing when they try to write to the document that invoked the plug-in. The 
name of the frame to receive the HTML page generated by the plug-in can be passed in using the 
target frame option. This target frame needs to be a named frame in the same frameset as the frame 
invoking the plug-in. 


Internet Explorer Browser Customization 


+ “HTML Script Example” on page 79 
+ “HTML Code Example” on page 80 


HTML Script Example 


The ExecuteRequest() entry point simplifies HTML coding when working with Internet Explorer. 
It lets you pass/get information from the ¡Print without having to reload a Web page. 


A result type called object is implemented and should be used only in conjunction with 
ExecuteRequest(). You can use ExecuteRequest and have it return results via HTML, URL, 
message box, or cookie. All data can be passed via the ExecuteRequest() second parameter. The 
first parameter is the operation. Both of the parameters are strings. 


Syntax: variable=variable.ExecuteRequest("operation_string",additional_operation strings); 
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<object ID=iPrintAccess classid=c1sid:36723f97-7aa0-11d4-8919-ff2d71d0d32c> 
</object> 

<script Language="Javascriptl1.1"> 

var pStatus; 

var params; 


params = "printer-url=" + printerNameHere + "&result-—type=object" 


pStatus=iPrintAccess.ExecuteRequest ("op-printer-get-status", params); 
alert (pStatus) ; 


</script> 


HTML Code Example 


The following defines the interface between HTML pages and the browser plug-in. The HTML 
element <OBJECT> is used to invoke the Internet Explorer plug-in (IENIPP.OCX). 


<OBJECT ID=TESTID 


CLASSID="clsid:36723£97-7aa0-11d4-8919-FF2D71D0D32C" 


<PARAM NAME=operation VALUE=op-printer-get-status> 


<PARAM NAME=printer-url VALUE=http://172.16.123.25/ipp/lpr> 


<PARAM NAME=result-type VALUE=html> 


<PARAM NAME=target-frame VALUE=displayFrameName> 


</OBJECT> 


Netscape Browser Customization 


The following defines the interface between HTML pages and the browser plug-in. The HTML 
element <EMBED> is used to invoke the Netscape plug-in (NPNIPP.DLL). 


<EMBED TYPE=application/x-Novell-ipp 
width=100 


height=30 


operation=op-printer-get-status 
printer-url=http://172.16.123.25/ipp/l1pr 
result-type=html 


target-frame=displayFrameName 


HTML Parameters 


The following parameters can be used to enhance the ¡Print HTML pages. The parameters are used 
in the HTML files as PARAM NAME=parameter VALUE=identifier statements. 


+ call-back-url (page 81) 
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call-back-url 


debug 


driver-options 


error-type 


+ 


debug (page 81) 


+ 


driver-options (page 81) 


+ 


error-type (page 81) 


+ 


file-path-name (page 82) 


+ 


job-list (page 82) 


+ 


job-list-options (page 82) 


+ 


persistence (page 83) 


+ 


printer-url (page 83) 


result-type (page 83) 
target-frame (page 84) 


+ 


+ 


Used to target the results from the onchange JavaScript function associated with selecting jobs 
from the job list. The JavaScript function causes the browser to reload the indicated control frame 
passing the list of selected jobs as a parameter. 


Example: 


PARAM NAME-=call-back-url VALUE=CONTROL.HTM 


If debug is set to True, message boxes with debug and profiling information are displayed. 


Example: PARAM NAME=debug VALUE=true 


As a printer is being installed, the plug-in can optionally set some default driver options. For a list 
of driver options, see “Changing Printer Driver Default Install Options” on page 41. 


Example: 


PARAM NAME=driver-options VALUE=papersize:A4;duplex:vertical;color:false 


Used to tell the plug-in how to report errors associated with the requested operation. The plug-in 
has the ability to return the errors in. 


Option Description 

none No response. 

msgBox Display results in a message box. 

html Display results as an HTML page generated by the plug-in. 
cookie Put the error information in a cookie. 
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file-path-name 


job-list 


job-list-options 


Option Description 
url Pass the results as a url parameter. 


object Returns a delimited string. 


The plug-in defaults to the same reply mechanism that is specified in results-type 1f error-type 1s 
not specified. 


Example: 


PARAM NAME-error-type VALUE=html 


Specifies a printer ready file that can be passed to the plug-in for printing. This mechanism 
bypasses the print provider and the printer driver. The printer does not need to be installed on the 
workstation to use this operation. 


Example: 


PARAM NAME=file-path-name VALUE=directory path filename 


The plug-in can perform several operations on jobs. job-list is a comma-delimited string of job IDs 
to indicate which jobs to operate on. A job list with the job ID of -1 is equivalent to selecting all 
jobs 

Example: 


PARAM NAME+job-list VALUE=3,5,7 


When the plug-in creates the HTML for job-list, it can add buttons to allow the user to hold, 
resume, delete, or display information for selected jobs. This parameter is used to specify which 
buttons to display and support. 


The following are the possible buttons: 
op-job-hold (page 86) 
op-job-hold-release (page 86) 


+ 


+ 


+ op-job-cancel (page 85) 
+ op-job-get-info (page 85) 
Example: 


PARAM NAME=job-list-options VALUE=op-job-hold,op-job-hold-release,op-job-cancel, op- 
job-get-info 
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persistence 


printer-url 


result-type 


Printer installation can be temporary or permanent. If not specified, persistence defaults to 


persistent. Persistence is used to indicate the duration the printer is to be installed for. The choices 


include the following: 


Option Description 

persistent Printer will not be removed. 

volatile-reboot Printer will be removed as the workstation reboots. 
volatile-date-time Printer will be removed at the indicated time (year, 


month, day, hour, minute). 


Examples: 
PARAM NAME-persistence VALUE=volatile-reboot 
PARAM NAME-persistence VALUE=volatile-date-time:2004,3,12,20,160 


Indicates which printer the operation should be directed to. 
Example: 


PARAM NAME=printer-url VALUE=ipp://print. MyCompany.com/ipp/ColorPrinter1 


Used to tell the plug-in how to report the results of the requested operation. The plug-in has the 


ability to return the results in one of the following ways: 


Option Description 

none No response. 

msgBox Displays results in a message box. 

html Displays results as an HTML page generated by the 
plug-in. 

cookie Puts the results in a cookie. 

url Passes the results as a url parameter. 

object Returns a delimited string. 


The plug-in defaults to none if results-type is not specified. 
Example: 


PARAM NAME=result-type VALUE=html 
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target-frame 


Used to specify the name of the frame in which to put the results and/or error information into. If 
the operation results type is url, the target frame will be the one reloaded with the indicated URL. 


Example: 


PARAM NAME =rarget-frame VALUE=FrameName 


Supported Operation Strings 


All requests to the plug-in have two required parameters. The first is operation, and the second is 
result-type. All operations except op-client-interface-version and op-client-version-info require 
the parameter printer-url. All requests support the optional parameter error-type. 


With the exception of op-printer-send-test-page and op-printer-remove the printer does not need 
to be installed to use the following operations: 


+ op-client-interface version (page 84) 
¢ op-client-is-printer-installed (page 85) 
+ op-client-version-info (page 85) 

+ op-job-cancel (page 85) 

+ op-job-get-info (page 85) 

+ op-job-hold (page 86) 

+ op-job-hold-release (page 86) 

+ op-printer-get-info (page 86) 

+ op-printer-get-status (page 86) 

+ op-printer-install (page 87) 

+ op-printer-list-all-jobs (page 87) 

+ op-printer-pause (page 87) 

+ op-printer-purge-jobs (page 87) 

+ op-printer-remove (page 88) 

+ op-printer-resume (page 88) 

+ op-printer-send-file (page 88) 

+ op-printer-send-test-page (page 88) 


op-client-interface version 


Description: Determines a version associated with the plug-in’s HTML 
interface. Can also determine if a client upgrade needs to be 
invoked or for any other client plug-in/HTML file compatibility 
issues. 


Required None 
information: 
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op-client-is-printer-installed 


op-client-version-info 


op-job-cancel 


op-job-get-info 


Supported 


return types: 


URL, Cookie, Object 


Description: Determines if the indicated printer is installed on the 
workstation. 

Required Printer URL 

information: 

Supported URL, Cookie, Object 


return types: 


Description: Determines the version of the Novell iPrint Client files running 
on the workstation. 

Required None 

information: 

Supported Cookie, URL, Object 


return types: 


Description: Deletes the indicated jobs. 
Required Printer URL, job-list 
information 

Supported None 


return types: 


Description: Gets job information for indicated jobs. The information 
returned depends on the printer's capabilities. This information 
can include job name, ID, owner, size, bytes processed, hold 
until, priority, time created, time started printing, and time 
finished printing. 

Required Printer URL, job-list 

information: 

Supported Message box, HTML, URL, Cookie, Object 


return types: 
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op-job-hold 


Description: Puts a hold on the indicated jobs. A job that is printing might not 
be held. 

Required Printer URL, job-list 

information: 

Supported None 


return types: 


Supported parameter is indefinite. 


op-job-hold-release 
Description: Removes the hold on the indicated jobs. 
Required Printer URL, job-list 
information: 
Supported None 


return types: 


op-printer-get-info 


Description: Gets additional information about the printer. The information 
returned depends on the printer's capabilities. This information 
can include printer location, printer make and model, and 
supported document formats (PDLs). 


Required Printer URL 
information: 
Supported Message box, HTML, URL, Cookie, Object 


return types: 


op-printer-get-status 


Description: Gets status information from the indicated printer. The 
information returned depends on the printer’s capabilities. 
Status can include printer state, printer state reasons, printer 
state message, printer accepting jobs, and printer job count. 


Required Printer URL 
information: 
Supported Message box, HTML, URL, Cookie, Object 


return types: 
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op-printer-install 


Description: Installs the indicated printer to this workstation. 
Required Printer URL 

information: 

Optional driver-options, persistence 

information: 

Supported None, Message box, HTML, URL, Cookie, Object 


return types: 


op-printer-list-all-jobs 


Description: Lists jobs for this printer. 

Required Printer URL 

information: 

Supported Message box, HTML, URL, Cookie, Object 


return types: 


op-printer-list-users-jobs 


Description: Lists jobs for this printer. 

Required Printer URL??? 

information: 

Supported Message box, HTML, URL, Cookie, Object 


return types: 


op-printer-pause 


Description: Pauses the printer. If results are requested for this operation, 
the op-printer-get-status operation is executed to provide the 
new printer status. 


Required Printer URL 
information: 
Supported None, Message box, HTML, URL, Cookie, Object 


return types: 


op-printer-purge-jobs 


Description: Deletes all jobs for this printer. 
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Required Printer URL 
information: 


Supported None, Message box, HTML, URL, Cookie, Object 
return types: 


op-printer-remove 
Description: Deletes the indicated printer from this workstation. 
Required Printer URL 
information: 
Supported None, Message box, HTML, Object 
return types: 
op-printer-resume 


Description: Resumes the printer. If results are requested for this operation, 
the op-printer-get-status operation is executed to provide the 
new printer status. 


Required Printer URL 
information: 
Supported None, Message box, HTML, URL, Cookie, Object 


return types: 


op-printer-send-file 


Description: Sends a printer-ready file to this printer. 
Required Printer URL, file-path-name 
information: 

Supported None, Message box, Object 


return types: 


op-printer-send-test-page 


Description: Sends a test page to this printer. 

Required Printer URL 

information: 

Supported None, Message box, HTML, URL, Cookie, Object 


return types: 
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Understanding iPrint and Novell Distributed 
Print Services 


Novell ¡Print utilizes the Novell® Distributed Print Services™ (NDPS®) infrastructure. iPrint 
enhances the users’ experience by providing a Web view of their printing environment. In addition 
to NDPS, iPrint uses the following components: 


¢ A print provider and a set of browser plug-ins. 
These are installed on a user’s workstation. The Novell Client™ is not required. 
+ Ippsrvr.nim. This runs on the NetWare® server. 


When an eDirectory Printer object is configured as an iPrint printer, the Print Manager 
automatically loads this NLM™ on the server, which generates a URL for the printer. 


+ A set of HTML pages. 


These are provided to install the iPrint client software and printers as well as to view and 
manage print jobs. These pages are customizable. For more information, see Chapter 4, 
“Customizing iPrint,” on page 37. 


NDPS infrastructure is designed to handle the increased complexity of managing printing devices 
in any type of network environment, ranging in size from small workgroups to enterprise-wide 
systems. NDPS allows you to use Novell iManager, Novell’s Web-based management tool. You 
can also designate those printers for automatic installation on user workstations, without any 
action by your users. 


NDPS replaces the existing queue-based printing technology. You don't need to set up print 
queues, printer objects, or print servers, and link them together. Instead, all of your management 
tasks are focused on the printer itself, which can be configured as an eDirectory™ object. 


To better understand how NDPS works, read the following sections: 
+ “Overview of NDPS Infrastructure” on page 89 
+ “Comparing NDPS with Queue-Based Print Services” on page 93 
+ “Understanding the Architecture of NDPS” on page 94 


Overview of NDPS Infrastructure 


The NDPS infrastructure is automatically installed when you choose to install iPrint. Novell's 
legacy, queue-based print system is also fully supported, which allows your users to continue 
printing as they always have until you complete the transition to iPrint. 


Some of the most significant features of NDPS include the following: 
¢ Bidirectional Feedback and Control (page 90) 
+ Configurable Event Notification (page 90) 
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+ Tight Integration with eDirectory (page 91) 

+ Automatic Printer Driver Download and End User Convenience (page 91) 

¢ Printer and Job Configuration Options (page 92) 

+ Job Scheduling Options (page 92) 

+ Protocol Independence (page 92) 

+ Compatibility with Multiple Clients, Applications, and Operating Systems (page 92) 
¢ Support for Existing Printers (Full Backward Compatibility) (page 93) 


Bidirectional Feedback and Control 


Novell Distributed Print Services lets clients and printers exchange information about printers and 
print jobs. For example, this interchange allows users and administrators to get real-time 
information about a printer such as 


+ Its status 


For example, it reports such information as whether the printer needs toner or paper, whether 
it is online, and whether the lid is open. 


¢ Its configuration properties and features 


For example, does it support color? Duplexing? How many pages has it printed since it was 
last serviced? 


NDPS also lets you view information about a print job's properties and status, including 
¢ The number of copies being printed 


¢ Job hold and scheduling information 


¢ Notification when the job has actually been completed 


The bidirectional feedback provided by NDPS is limited only by the bidirectional capabilities of 
the printer itself. In many cases, NDPS actually enhances information provided about printers that 
do not have bidirectional capabilities. 


Configurable Event Notification 


90 


With Novell Distributed Print Services, you can customize event notification. Event notification 
allows you to specify who should be notified of an event or problem, and how that person should 
be notified. It also allows you to identify the specific events or problems that you want notification 
messages sent for. For example, you can configure notification so that the owner of a print job will 
receive a pop-up message when the job has actually been printed. 
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Print 5 copies of this job at the 
color printer on the second floor at 
3 p.m. and notify the department 
admin when it is complete. 


You can also ensure that the printer operator is notified when a problem such as a paper jam occurs 
on the printer. Notification methods provided by NDPS include pop-up messages, e-mail, and log 
file records, while third-parties can develop other mechanisms such as beeper notification 1f they 
wish. 


Tight Integration with eDirectory 


Novell Distributed Print Services is designed to take full advantage of Novell eDirectory. 
Integration with eDirectory allows you to create a single eDirectory object—an NDPS Printer 
object—to represent each printer on the network. As a Printer object, printers become as secure as 
the other objects in the tree, and they are just as easy to manage. 


In the eDirectory tree, printers can be conveniently grouped. For example, you can group and 
manage all of your printers by department, workgroup, or location. You can also search for printers 
with specific capabilities, because those capabilities are properties of the NDPS printer object. 


Automatic Printer Driver Download and End User Convenience 


Not only does NDPS make printer management easier for you as an administrator, it also makes 
printing easier for end users. NDPS provides a database that includes drivers for most printers in 
common use today. From this database, you can select drivers you want to be automatically 
installed on client workstations when a user adds a printer. This eliminates the need for users to 
provide the printer driver themselves. You can add drivers to this database as they become 
available. 
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An NDPS client can also modify printer configurations. For example, a user can configure a printer 
to use a different size paper or to print a cover page. Users can change the properties of any 
installed printer that the administrator has not locked. Also, using NDPS, users can view the 
current status of any available printer to see how many print jobs are waiting to be printed before 
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they send their jobs. These NDPS features help make end-user printing easier and more effective 
than the methods of the past. 


From this list, you can select drivers you want to be automatically downloaded and installed on 
client workstations. You can add drivers to this database as they become available. 


Printer and Job Configuration Options 


The NDPS interface supports many printer options in common use today, while the open 
architecture of NDPS allows printer manufacturers to add their own custom interfaces for specific 
printers. This means that as new printer features become available, you can access them through 
NDPS. 


Job Scheduling Options 


NDPS allows you to configure and schedule print jobs to be processed according to time of day, 
job size, or media availability. 


Protocol Independence 


The entire NDPS architecture is protocol independent. NDPS can be used in an IPX-based 
environment, a pure TCP/IP environment, or a combination of both. The third-party gateways 
being developed to work with NDPS are also protocol independent. 


Most printers that support TCP/IP today do not have a discovery protocol like SAP for IPX-based 
networks. The Service Locator Protocol (SLP) will eventually be embedded in printers and will 
provide a discovery protocol that can be used with NDPS. 


Compatibility with Multiple Clients, Applications, and Operating Systems 


92 


NDPS provides an enhanced Windows* client to take advantage of all of the advanced features 
provided by NDPS. All clients that are not NDPS-aware can still print to NDPS printers, and you 
can use all of your existing applications with NDPS. Although your queue-based print clients 
won't be able to take full advantage of the advanced features available in NDPS, they won't lose 
any of the printing ability they have now. This backward-compatibility feature of NDPS makes it 
well suited for heterogeneous networks. 
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ADVANCED NDPS FEATURES 


Support for Existing Printers (Full Backward Compatibility) 


NDPS lets you preserve your investment in your existing printing resources. All clients can print 
to legacy printers. All currently available printers can be used in NDPS environments. In fact, 
major printer manufacturers have developed gateways for their existing printers to enable them to 
take advantage of many new features available with NDPS. 


Comparing NDPS with Queue-Based Print Services 


The architecture of Novell legacy queue-based print services was based on the creation and linking 
of three components: printers, print queues, and print servers. Setting up queue-based printing was 
often a complex task. In order to print, users first had to capture the printer port. Then the client 
would redirect the data to a file in a print queue, where it was stored while waiting to be sent to a 
printer by the print server. 


With NDPS, printer, print queue, and print server functions are combined into a single entity called 
a Printer Agent. The need to create print queues has been eliminated, and users send print jobs 
directly to printers. 


Even though NDPS does not require queues, your networks might continue to include queue-based 
printers and clients not currently supported by NDPS. The backward compatibility of NDPS 
allows you to continue using these queue-based services and resources transparently, as is 
illustrated in the following scenarios: 


+ You can print through NDPS to an existing queue, allowing you to access systems that require 
a queue connection (for example, mainframe systems using NetWare HostPrint® and certain 
proprietary systems). 


+ NDPS can service existing queues, allowing you to use NDPS on the server even though your 
client platform is not currently running NDPS. This allows you to install and run NDPS while 
you are changing your client workstations to NDPS. 


For a discussion of NDPS support for legacy printing, see “Supporting Queue-Based Client 
Workstations” on page 62. 


The following table summarizes the major differences between NDPS and queue-based printing 
services. 
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Queue-Based (Legacy) Print Services 


Administrators create and link print queues, 
printers, and print servers, and users submit 
print jobs to the queues. These three objects 
must be maintained separately once the 
system is in place. 


Novell Distributed Print Services 


Administrators create Printer Agents, allowing users to 
submit print jobs directly to printers. All management 
functions are centered on the printer itself. 


Unidirectional communications only. 
Feedback consists of pop-up windows 
reporting a nonconfigurable set of events. 


Bidirectional communications supported. Configurable 
event notification includes e-mail, pop-up windows, 
event logs and other methods, including third-party 
methods such as beepers and faxes. Events reported 
are limited only by a printer's capability. 


Does not accommodate add-ons or 
extensions from third parties. 


Extensible framework for print devices, including 
snap-in interfaces. 


Understanding the Architecture of NDPS 


The architecture of Novell Distributed Print Services ensures the scalability of the printing 
environment, allowing you to print in LAN, WAN, and enterprise document production 
environments. It also allows you to print to devices ranging from simple dot-matrix printers to 
laser printers and large-scale production devices. 
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To understand exactly how NDPS works, you need to understand its major architectural 
components. See the following sections for information on the various components: 


+ “Understanding Printer Agents” on page 95 


¢ “Understanding the NDPS Manager” on page 96 


+ “Understanding Printer Gateways” on page 97 


+ “Understanding the Broker” on page 98 
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Understanding Printer Agents 


Before a printer can be incorporated into a NDPS printing environment, it must be represented by 
a Printer Agent. No Printer Agent can represent more than one printer, and no printer can be 
represented by more than one Printer Agent. 


The Printer Agent lies at the heart of NDPS, combining the functions previously performed by a 
printer, print queue, print server, and spooler into one intelligent and simplified entity. 


The Printer Agent can be any of the following: 


+ A software entity running on a server that represents a printer attached to a server or 
workstation. 


attached 


Server printer 


+ An entity embedded within a network-attached printer. 


Network- 
attached 


printer ES 


A Printer Agent provides the following services: 


+ It manages the processing of print jobs and many operations performed by the printer itself. 


Client Printer 
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+ It answers queries from network clients about a print job or document, or about the attributes 
of the printer. 


: I . 
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N cp queries 


+ It generates event notification so that interested parties can be notified of job completion, 
printing problems, errors, or changes in the status of a print job, document, or printer. 


3 


Client Printer 


For information about other major NDPS components, see the following: 
+ “Understanding the NDPS Manager” on page 96 
¢ “Understanding Printer Gateways” on page 97 


+ “Understanding the Broker” on page 98 
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Understanding the NDPS Manager 
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A NDPS Manager provides a platform for Printer Agents that reside on the server. An NDPS 
Manager must be created as an object in the eDirectory tree before you can create server-based 
Printer Agents. 


The NDPS Manager object stores information used by the NetWare Loadable Module™ (NLM™), 
NDPSM.NLM. You can manually load this NLM at the server console. 


A single NDPS Manager can control multiple Printer Agents. (There is no hard limit.) 


A specific NDPS Manager can be loaded only on one server. If it controls a local printer, it must 
be loaded on the server that the local printer is attached to. 


While you can perform some configuration and management tasks directly through the NDPS 
Manager console interface, Novell iManager is the main tool for performing these tasks. 
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For information about other major NDPS components, see the following: 
+ “Understanding Printer Agents” on page 95 
+ “Understanding Printer Gateways” on page 97 


+ “Understanding the Broker” on page 98 
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Understanding Printer Gateways 


Gateways allow NDPS clients to send jobs to printers that are not NDPS-aware (that is, printers 
that are not equipped with embedded NDPS Printer Agents). You select and configure a printer 
gateway when you create a new Printer Agent. 


Gateways translate NDPS queries or commands to printer-specific language that the physical 
printer can use. This is possible because gateways are configured to know the specific type (make 
and model) of printer being used. 


The following diagram illustrates a typical gateway configuration. 
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Third-party gateways are developed by printer manufacturers to support printers directly attached 
to the network. Because these gateways are developed to interact with specific proprietary printers, 
they can provide a wider array of information and offer options that are not available for the 
generic Novell gateway. Some third-party gateways provide utilities that can be configured to 
automatically create Printer Agents when one of their printers is attached to the network. 


The Novell gateway is designed to be used with printers that don't have an embedded Printer Agent 
and don't yet have a proprietary, third-party gateway provided for them by their manufacturers. 


For information about other major NDPS components, see the following: 
+ “Understanding Printer Agents” on page 95 
+ “Understanding the NDPS Manager” on page 96 
+ “Understanding the Broker” on page 98 
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Understanding the Broker 


The Broker provides three network support services not previously available in NetWare: the 
Service Registry Service (SRS), Event Notification Service (ENS), and Resource Management 
Service (RMS). 


While these services are invisible to end users, network administrators should be aware of them. 
NDPS uses these services in the following ways: 


+ Service Registry Service. The Service Registry allows printers to advertise themselves so 
that administrators and users can find them. This service maintains information about device 
type, device name, device address, and device-specific information such as the manufacturer 
and model number. See “Understanding the Service Registry Service” on page 98. 


+ Event Notification Service. This service allows printers to send customizable notifications 
to users and operators about printer events and print job status. The Notification Service 
supports a variety of delivery methods including NetWare pop-up, log file, e-mail, and 
programmatic. See “Understanding the Event Notification Service” on page 99. 


+ Resource Management Service. This service allows resources to be installed in a central 
location and then downloaded to clients, printers, or any other entity on the network that needs 
them. The Resource Management Service supports adding, listing, and replacing resources 
including printer drivers, printer definition (PDF) files, banners, and fonts. See 
“Understanding the Resource Management Service” on page 100. 


For information about other major NDPS components, see the following: 
+ “Understanding Printer Agents” on page 95 
¢ “Understanding the NDPS Manager” on page 96 


+ “Understanding Printer Gateways” on page 97 
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Understanding the Service Registry Service 


The Service Registry allows printers to advertise themselves so that administrators and users can 
find them. This service maintains information about device type, device name, device address, and 
device-specific information such as the printer manufacturer and model number. 
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Service Registry 
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Before Novell Distributed Print Services (NDPS), each printer had to periodically advertise its 
availability through the Service Advertising Protocol (SAP), which was effective but created a lot 
of traffic on the wire. 


The Service Registry Service helps minimize the network traffic problem created by many printers 
advertising through the SAP. (For information on turning off the SAP, see the documentation for 
your printer.). When an application or user wants to use a printer, it can contact an SRS and retrieve 
a list of all registered printers on the network. 


NOTE: For IPX, the SRS uses SAP type 8202; for IP environments, it uses Multicast. 
If there are multiple Service Registries running on the network, they synchronize automatically. 


In addition to printer information, the SRS also maintains lists of other services available, such as 
Event Notification Services and Resource Management Services. For more information, see 
“Understanding the Event Notification Service” on page 99, “Understanding the Resource 
Management Service” on page 100, and “Enabling and Disabling Brokered Services” on page 68. 


Understanding the Event Notification Service 


Novell Distributed Print Services (NDPS) printers can be configured to provide event notification 
regarding print jobs and printer status. Administrators can configure event notification for 
interested parties, that is, non-job-owners that you wish to be notified of a defined printer or server 
event that occurs during the processing and printing of a job. See “Configuring Interested-Party 
Notification” on page 61 for more information. 


Understanding iPrint and Novell Distributed Print Services 99 


Delivery Methods 


Notification Service 


ai printer events, | 
Broker Seau print job status, | 
| 


i etc. 
l : 
l 
E Ne 
y KIA 

screen : e-mail 3rd-party 
pop-up file : notify 

a “a 


User Operator 


The Event Notification service supports both consumers of events (users) and suppliers of events 
(printers). Users can register with the ENS by identifying the types of events they want to be 
notified about, while the printer can register the kinds of events it is capable of reporting. For 
example, the administrator for a specific printer (by default a Manager of that printer) can 
designate an Operator to be notified if the printer runs out of paper or if the toner is low. Similarly, 
users can be notified when their jobs have finished printing. 


The availability of the following delivery options is dependent on which of them you have enabled. 
(See “Enabling Event Notification Delivery Methods” on page 67 for more information.) 


+ Pop-up notification. Messages will pop up on the screen for individuals designated to receive 
them. (Pop-up notification is always enabled when the ENS is enabled.) 


+ SMTP notification. Messages will be sent to the recipient through SMTP (Simple Mail 
Transfer Protocol) in IP-based systems. 


+ Log file notification. Messages are written to a file at a designated location on a NetWare 
server that the recipient has rights to. 


+ Programmatic notification. Two programmatic notification delivery methods are shipped 
with NDPS: SPX™ and RPC. 


The open architecture of NDPS allows third parties to develop additional delivery methods as well. 


NDPS is enabled to work with SNMP. In addition, some third-party gateways are SNMP-enabled 
independently of the NDPS software. 


For more information about other brokered services, see the following: 
+ “Understanding the Service Registry Service” on page 98 


+ “Understanding the Resource Management Service” on page 100 


Understanding the Resource Management Service 


This service allows resources to be installed in a central location and then downloaded to clients, 
printers, or any other entity on the network that needs that resource. It provides a single place 
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Resources 


Benefits 


where a variety of file types are stored for immediate access by Novell Distributed Print Services 
(NDPS). The Resource Management Service (RMS) supports adding, listing, and replacing 
resources including printer drivers, printer definition files (PDFs), banners, and fonts. 
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The Resource Management Service allows you to add, list, and replace the following resources: 
+ Banners (see “Adding Banner Pages” on page 64) 
+ Windows printer drivers (see “Adding or Updating Printer Drivers” on page 66) 


Some of the benefits offered by the Resource Management Service include 

¢ Improved resource sharing 

+ More manageable resource distribution and updating 

+ Automatic printer driver download from a central repository 

+ Plug-and-print printer availability 

¢ Availability of network resources to applications through a common interface 
For more information about other brokered services, see the following: 

+ “Understanding the Service Registry Service” on page 98 


+ “Understanding the Event Notification Service” on page 99 
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Planning the Migration to ¡Print 


Use the following sections to prepare your print system to be migrated to iPrint. 
+ “General Transition Guidelines” on page 103 
+ “Migrating from Queue-Based Printing to iPrint” on page 105 


+ “Associating a Printer Agent with a Queue” on page 106 


General Transition Guidelines 


The following guidelines generically apply to any transition scenario and should help you 
understand the migration process. 


You can make the transition gradually from queues to Novell® iPrint. If your users are running the 
Novell Client™ with the NDPS® component installed, you can first replace the server components 
of your legacy printing system with the iPrint server components. Because the Print Manager 
(ndpsm.nIm) and the Print Server (pserver.nlm) can run simultaneously on a server, this transition 
can be accomplished one queue/printer at a time. Users can then be gradually switched to print 
directly to iPrint printers instead of queues. 


This transitional configuration would look this way: 


MDPS 


Printer Agent Primier 


Novell 
Client Queue 


If your users do not have the NDPS component installed —later versions of the Novell Client did 
not install the NDPS component by default—create your 1Print system, then have your users 
remove their old printers and install the ¡Print client and printers. 


See “Maintaining Your Queues during the Transition” on page 104 for more details on this printing 
configuration. 


Eventually, only a few queues serviced by Printer Agents will remain to support your DOS and 
Windows DOS-box printing needs. These few users can be migrated from queues by other 
methods. See “Using the Novell ¡Capture LPT Port Redirector Utility” on page 31 or “Using 
Icapture.exe to Capture Printer Ports” on page 32 for more information. 
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Making the Transition Gradually 


If you are using a queue-based printing system, you can continue to use your existing system 
without modification. Because of the advantages provided by iPrint, however, we recommend that 
you begin the transition as soon as it becomes convenient. 


In general, we suggest you make the move gradually, and begin by implementing the ¡Print server 
components and management features. This strategy allows you to set up your new printers and 
optimize the distribution of your brokered resources while your end users continue printing 
through the same queues they always have. Then, when you are satisfied that your NDPS printing 
components are set up and configured the way you want them, you can begin upgrading your end 
users to the new system. 


If you will be implementing iPrint, the Novell Client is not required. Instead, users install a 
browser plug-in that allows them to install printers and printer drivers to their workstations. 


Maintaining Your Queues during the Transition 


Printer Agents can be configured to retrieve jobs from queues in addition to accepting jobs from 
Novell Client users. 
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Maintaining your queues allows you to gradually migrate users to iPrint because users' 
workstations can continue to print to existing queues and be moved to iPrint as time permits. 
Workstations can even be configured to print to both queues and iPrint printers, if the NDPS 
component of the Novell Client is installed. 


NOTE: Later versions of the Novell Client did not install the NDPS component by default. 


After you have created ¡Print Printer objects to represent the printers that are still servicing queues, 
you can delete your legacy Print Server and Printer objects (but not your Queue objects) if you 
want, reducing the number of objects in your tree you need to manage. 


Understanding Your Implementation Options 


Possible scenarios for printing with NetWare range from maintaining a legacy queue-based system 
(available only for systems based on IPX™), to integrating iPrint into a heterogeneous print 
system, to implementing a pure iPrint printing system in a Pure IP environment. A wide range of 
heterogeneous configurations exist between all IPX and Pure IP systems, and between all-queue- 
based and all-iPrint systems. However, becoming one hundred percent Pure IP and utilizing the 
most advanced printing features of NetWare® implies full deployment of iPrint. 


Keep in mind that there is no requirement to modify current NetWare printing configurations 
immediately, and any modifications you make can be implemented gradually (see “Making the 
Transition Gradually” on page 104). 
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Migrating from Queue-Based Printing to ¡Print 


Most queue-based printing in NetWare networks is currently realized through one of the following 


configurations: 
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When migrating to ¡Print from any of these configurations, you should first consider the protocols, 
connection methods used, and potential need to configure the printer in determining which 
gateway to use. Ifa third-party gateway is used, the resulting configuration would look as follows: 


Printer 
The Novell gateway provides a straightforward migration path. The ¡Print configurations 


corresponding to the queue-based printing configurations illustrated earlier, as well as an 
additional configuration for Pure IP support, are shown in the following illustration. 


Planning the Migration to iPrint 105 


Associating 


Q QServer-mode 


n "5 
== Cfo 
` Rs 


Novell Client 


Printer attached to 
workstation 


Printer attached to server 
(local printer) 


The configuration 1 is not recommended because a back-end queue is still required, increasing 
network traffic and delaying job completion. In addition, while transitioning to iPrint, there would 
be two queues in the print path as shown. 


Configureation option 2 is no longer supported. Choose configuration 5 if the network supports IP 
and the printer supports LPR/LPD. Configurations 3 and 4 are available if the printer does not 
support LPR, but you still want to benefit from many ¡Print features without the need for a queue. 
Configurations 2 through 5 require you to configure the print device to enable a new protocol. 


Because iPrint is based upon Novell Distributed Print Services® as the back end, you must first 
implement NDPS. For more information on migrating to NDPS, see Planning (http:// 
www.novell.com/documentation/lg/nw51/ndps_enu/data/hoktwpmn.html) in the Novell 
Distributed Print Services Administration Guide for NetWare 5.1. 


a Printer Agent with a Queue 
Use NWAdmin to manage queue-based print systems. Implementation of this phase will in no way 
disable your current eDirectory queue-based printing environment. 


1 From NWAdmin, right-click the ¡Print Printer object you want users to print to, then select 
Details. 


If the previous procedures were performed properly, you should now see all the buttons 
activated within the printer's opening bitmap. 


2 Click Jobs-V. 
3 From the menu, select Spooling Configuration. 
At the bottom of the form, you will see a field labeled Service Jobs from NetWare Queues. 
4 Click Add and select the existing NDS queues you want to assign for the printer. 
5 Click OK and close the bitmap. 
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Remaining inside NWAdmin, find the existing NDS Print Server object that represents the 
NDS Print Queue object you just transitioned, right-click it, and select Details. 


Click Assignments. 


Select the printer object that was servicing the NDS print queue object or was just 
transitioned, then click Delete. 


Click OK, then click Close. 


Remaining inside NWAdmin, find the existing NDS Printer object that represents the NDS 
Print Queue object you just transitioned, right-click on it, and select Details. 


Click Assignments. 
From the bottom page, verify that the Default Print Queue is unchanged. 
The Print Server field should now be empty. Do not delete the queue field. 
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Troubleshooting Your Print System 


This section focuses on troubleshooting issues that might arise during printing. It also presents 
general principles that can be of value for a variety of network printer configurations, and 1t 
provides help for troubleshooting problems with the printer itself. 


+ 


+ 


+ 


“Initial Troubleshooting Steps” on page 110 

“Narrowing Your Focus” on page 113 

“Determining Your Platform When Problem Affects Only One Workstation” on page 115 
“Isolating Printing Problems Affecting Only One Windows Workstation” on page 117 
“Tracking Jobs from a Workstation” on page 119 

“Checking Printer Output and Using Test Files” on page 121 

“Printing Problems Affecting All Users” on page 123 


“Problems Integrating with Queue-Based Components” on page 125 
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Initial Troubleshooting Steps 
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A1. Attempt to resolve the error and try again 


With many printing problems, an error will be reported on the printer, the client trying to print, or 
the server. If an error condition exists, use the information provided to try to resolve the problem 
and then try again. If the error is on the printer, see your printer's operating manual. 


A2. Try some quick fixes 


Many times, printing problems occur due to simple or temporary conditions. The following are 
some common quick-fix techniques. 


If the problem is limited to a single workstation client, try the following: 
+ Check the printer's job list to ensure the job is getting to the spooling area. 


+ Review what has changed since the printer was working properly. 
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+ Check printer forms and job configurations. 


If the problem is affecting other workstation clients, try the following: 
+ Check Printer Information in the Novell ¡Manager for printing error messages. 


¢ Look for printer error conditions (such as beeps or LCD panel lights) and printing error 
messages. 


+ Turn the printer off and on. 

+ Check the printer's cabling. 

+ Look for messages on the server console. 

+ Check the printer's job list to ensure the job is getting to the spooling area. 
+ Review what has changed since the printer was working properly. 

+ Check printer forms and job configurations. 

+ Search the online Novell Support Connection™ for known issues. 


+ Make sure you have the most current ¡Print software. 


A3. Determining your printing environment 


If there is no obvious solution to the problem, then you will need to begin analyzing your printing 
system. In order to find the problem, the printing environment being used must be identified. 


NetWare provides two printing environments: the legacy queue-based printing (see “A4. All 
queue-based environment” on page 111) and iPrint (see “A5. All iPrint environment” on 

page 112). Either print system can be used alone or the two can be used together (see “A6. Mixed 
iPrint and queue-based environment” on page 112). Here are some ways to determine your 
printing environment: 


+ User. If the client platform is DOS, Macintosh, OS/2, or UNIX, these clients are not directly 
supported by iPrint and can only print to a network printer by submitting jobs to queues or use 
LPR printing. 


If the client platform is Windows, then they can be using either iPrint or queues. Check the 
printer configuration under the Windows control panel and check its network setting. Identify 
the network object being printed to and determine if it is a Queue object or a Printer object. 


+ Server files. At the server console look to see if the following are loaded: 
ndpsm.nlm (the server providing print services) 
pserver.nlm (the server has been, or still is, using queue-based printing) 


+ Novell iManager. Load Novell ¡Manager and look at printing object configurations to 
determine printing setup. 


A4. All queue-based environment 


If clients are submitting jobs to NetWare queues and the jobs are sent to the printer through the 
pserver.nlm, then you are using queue-based printing. 


Printing in a queue-based system consists of submitting jobs to a queue, from which the print 
server sends the job to the printer based on the settings of the Printer object. In queue-based 
printing, a problem usually occurs in one of three general areas: 
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+ Getting the print job into the print queue 
¢ Transferring the job to the printer in the proper format 
¢ Printing the job properly 
For more information, see Troubleshooting General Printing Problems (http://www.novell.com/ 


documentation/lg/nw5 1/printenu/data/hlgnvvum.html) in NetWare 5.1 Queue-Based Print 
Services. 


A5. All iPrint environment 


If you have the new client software and are submitting jobs to the printer through Printer Agents 
and a Print Device Subsystem, then you are using iPrint. See “Narrowing Your Focus” on page 113 
for more information. 


A6. Mixed iPrint and queue-based environment 


For backward compatibility, it is possible to be using both queue-based printing and iPrint 
together. Here are the two ways this can happen: 


+ Clients such as DOS, Macintosh, OS/2, and UNIX are unaware of ¡Print and are unable to 
submit jobs to Printer Agents directly. The clients must therefore send jobs to a print queue. 
A Printer Agent can be configured to emulate a print server and service jobs from the queue 
to an iPrint printer. 


+ Some network printers can receive jobs only from a NetWare queue and print server. Ifa client 
is configured to send jobs only to a Printer Agent, the Printer Agent might be configured to 
transfer the job to a queue where it can be serviced by a print server. 


Because two different print systems are being used, the problem could exist in either print system. 
See “Narrowing Your Focus” on page 113 to continue. 
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Narrowing Your Focus 


Chart B NDPS Troubleshooting 
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B1. Send job to same printer from other workstations 


Try printing to the same printer from one or more different workstation. This will help you narrow 
your search to the specific workstation or to the whole printing system. 


B2. Has workstation printed to this printer before? 


Has this workstation submitted jobs to this printer that printed successfully? Determine the 
following: 


+ Is this a new setup? 


¢ Is this the first time printing was attempted from this workstation since any changes were 
made? 


+ Has this setup been working before and now is not? 


If this is a new setup or a new configuration, then something might not be configured. 
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If a job sent from this workstation has been printed successfully before, go to “Determining Your 
Platform When Problem Affects Only One Workstation” on page 115 to further track the problem. 


B3. Gather information on setup and configuration 


The initial setup might have been done incorrectly. Refer to “Creating a Printer” on page 25 for 
more information. 


B4. Has printing ever worked with the current configuration? 


Have any users been able to print jobs from their workstations using this configuration? Determine 
the following: 


+ ITs this a new setup? 
¢ Is this the first time printing since any changes were made? 
¢ Has this setup been working before and now is not? 
If this is a new setup or a new configuration, then something might not be configured properly. 


If other users have been printing successfully, then go to “Tracking Jobs from a Workstation” on 
page 119 to further track the problem. 
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Determining Your Platform When Problem Affects Only One 
Workstation 


Chart C NDPS Troubleshooting 
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C1. Are queues being serviced by an iPrint printer? 


Clients running on DOS, Macintosh, OS/2, and UNIX platforms are either queue-based, meaning 
that they print to network printers by redirecting jobs to a queue, or set up for LPR printing. You 
will need to determine whether the network printer is being serviced by a queue-based print server 
(such as pserver.nlm) or if iPrint is redirecting jobs through a Printer Agent. 


C2. All queue-based printing 


If clients are submitting jobs to a queue that is being serviced by a print server, then the printing 
environment is all queue-based. For more information, see Troubleshooting General Printing 
Problems (http://www.novell.com/documentation/lg/nw5 1/printenu/data/hlgnvvum.html) in 
NetWare 5.1 Queue-Based Print Services. 
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C3. Queue-iPrint integration 


The clients are unaware of iPrint and are unable to submit jobs to Printer Agents directly. The 
clients must therefore send jobs to a print queue. A Printer Agent can be configured to emulate a 
print server and service jobs from the queue to a printer. See “Supporting Queue-Based Client 
Workstations” on page 62 for more information. Then go to “Printing Problems Affecting All 
Users” on page 123. 


C4. Look in Novell iManager for Printer objects 


Load Novell iManager and look to see if any Printer objects are defined. 


+ Tfno Printer objects are defined, there should be a Print Server object. Check the configuration 
of the print server to if the queue is configured to be serviced by it. 


+ If there are objects defined, look at the Printer objects to see if they are configured to emulate 
a print server and service jobs from a queue. 
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Isolating Printing Problems Affecting Only One Windows 
Workstation 
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D1. Check status of printer in Windows Control Panel 


Printing from a Windows environment introduces several complexities which might or might not 
be related to the network or the printer. Some problems can be found and resolved right in the 
Windows environment. Check the status of the printer in the Windows Control Panel to see if any 
problems are evident. 


D2. Check to see what network object the installed printer is servicing 


Determine the network object print jobs are being redirected to. 
1 Select the Printers folder from the Windows Control Panel or the Start/Settings menu. 
2 Select the installed printer and click File/Properties (or use the right-click Properties option). 
3 Click the Details tab. 
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4 Look at Print to the Following Port. 


Identify the network object being printed to and determine if it is a Queue object or a Printer 
object. 


D3. Check status of printer in NDPS Print Manager 


If the job did not appear in the job list, view information about the specific installed printer using 
the NDPS Print Manager Health Monitor, which is part of the NetWare Remote Manager. 


D4. Determine problem from error message 


With many printing problems, an error will be reported on the printer, the client trying to print, or 
the server. If an error condition exists, use the information provided to try to resolve the problem 
and then try again. If the error is on the printer, see your printer's operating manual. 


D5. NetWare queue object 


This printer is queue-based, meaning that the printer driver prints to network printers by 
redirecting jobs to a queue. 


D6. Are queues going to a printer? 


The next thing you need to know is whether the network printer is being serviced by a queue-based 
print server (such as pserver.nlm) or if ¡Print is redirecting jobs through a Printer Agent. Load 
Novell ¡Manager and look to see if any ¡Print Printer objects are defined. 


+ Ifno Printer objects are defined, there should be a Print Server object. Check the configuration 
of the print server to see if the queue is configured to be serviced by it. 


+ If there are Print objects defined, look at the Printer objects to see if they are configured to 
emulate a print server and service jobs from a queue. 


D7. Queue-iPrint integration 


The clients are submitting jobs to a print queue which is then being serviced by Printer Agents. 
See “Problems Integrating with Queue-Based Components” on page 125 for more information. 


D8. All queue-based printing 


If clients are submitting jobs to a queue that are being serviced by a print server, then the printing 
environment is all queue-based. For more information, see Troubleshooting General Printing 
Problems (http://www.novell.com/documentation/lg/nw5 1/printenu/data/hlgnvvum.html) in 
NetWare 5.1 Queue-Based Print Services. 


D9. Printer is set for working offline 


Under certain circumstances, the printer might be set for working offline. This can happen if 
Windows loses communication with the network, for example. A user can also set it offline. If the 
printer is set to work offline, reset it to online and try to print. If you cannot set the printer to online, 
then Windows has lost communication with the network print system. Reboot the workstation and 
if the condition still exists, check the client's connection to the network. 


118 Novell iPrint Administration Guide for NetWare 6.5 


D10. Other possibilities 


Other negative status flags. 


Tracking Jobs from a Workstation 
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E1. Pause output of printer 


One method of troubleshooting is putting stops in the printing process and then resending a job 
and testing how far in the process the job gets. The first stop you can make is pausing the printer 
output. 


Pausing printer output is a common technique used when troubleshooting printing; it forces ¡Print 
to spool your print job and save it as a file. Stopping and evaluating the printing process midway 
helps you to identify early problems and limits your troubleshooting to a few components. 


To pause printer output for a controlled access printer: 


1 In Novell iManager, click ¡Print > Manage Printer. 


Troubleshooting Your Print System 119 


2 Browse to and select the printer you want. 
3 Click the Pause Output button. 
The Pause Output button changes to Resume Output. 


E2. Check job list in Novell ¡Manager 


You can view the job list for a printer from Novell iManager, the server console, or the workstation 
Printer Manager. To view the job list from Novell iManager, see “Managing Print Jobs” on 
page 54. 


E3. Resume printer output 


To resume printer output for a controlled access printer, do the following: 


1 In Novell iManager, click ¡Print > Manage Printer and then select the printer you want to 
control. 


2 Click the Resume Output button. 
The Resume Output button changes to a Pause Output button. 


E4. Job printed this time but nothing was changed 


If the job printed now, there is no authoritative explanation as to why it didn't print the first time. 
If you followed these steps, no configurations have been changed; the job was only paused and 
released. Try printing the job again and see if normal printing continues. If not, try pausing the 
printer again and see if any other symptoms occur. 


E5. Job did not print and is still in the job list 


If the job does not print and is still in the job list, then check for job holds, delays, and priority 
settings. 


E6. Job did not print but is no longer in the job list 


If the job did not print, but it is not in the job list, then the job was sent to the printer and no error 
was reported back to the system. Check these issues: 


+ Are you are checking the correct physical printer? 
+ Are you are using the correct printer driver in your application? 


+ Are your drivers and printers talking the same language (for example Postscript or PCL)? 
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Checking Printer Output and Using Test Files 
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F1. Check availability of network printer 


Make sure that the printer is set to accept jobs. In Novell ¡Manager, verify that input is not paused. 


F2. Check for error messages 


With many printing problems, an error will be reported on the printer, the client trying to print, or 
the server. If an error condition exists, use the information provided to try to resolve the problem 
and then try again. If the error is on the printer, see your printer's operating manual. 


Also confirm that your Print objects are configured properly. 


F3. Test file prints but jobs from application do not 


If the test file prints but jobs from the application do not, then there is a problem with the way the 
job is being formatted by the application or handled by the driver. Reinstall the current printer 
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driver provided by the printer manufacturer. Also try printing from different applications to 
determine whether one application works while another does not. If this is the case, the problem 
is related to the application itself. 


F4. Job is being held in spooler 


The job is being held in the job spooler. Check for job holds, delays, and priority settings. If one 
of these conditions exists, change the status to print the job. If the job prints, then see “F3. Test file 
prints but jobs from application do not” on page 121. 


F5. Job did not print but is no longer in the job list 


If the job did not print but it is not in the job list, then the job was sent to the printer and no error 
was reported back to the system. Make sure you are checking the right physical printer. 
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Printing Problems Affecting All Users 
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G1. Determine severity and scope of printing problems 


If printing is affecting all users, determine the degree of severity of the printing problems. Can no 
users print from specific printers, or are no jobs printing from any network printer? Or are jobs 
printing, but printing slowly? 


G2. No print jobs are printing from any network printer 


If no users can print at all from any network printer, the problem is probably a universal problem 
such as 


¢ The printing system is disabled or printing system files are unloaded. 
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+ The servers are in a critical state due to problems with memory, disk space, LAN connections, 
etc. 


+ The LAN has a bottleneck or is otherwise dysfunctional. 


G3. No print jobs are coming from a specific printer 


If the printing problem is limited to a certain printer, then the problem is either at the printer itself 
or the configuration of the printer. Continue to determine which printing environment you are 
using. 


G4. Jobs are printing slowly or are corrupted 


Jobs might be printing but are either slow or appear corrupted. 


Slow Printing 
There are several explanations for slow printing. 


Ifonly one workstation is having problems with slow printing, the application might be generating 
the output for the printer. This can cause a long delay before the job is even sent to the spooler. 
Look at the print status of the application to determine if this is the case. 


If all workstations are having the problem, one of the following conditions might exist: 


¢ Interrupt conflicts might exist between the port and another device. Configure the printer for 
no interrupts (polled mode). 


+ The baud rate might be slow (serial printers). 
+ XON/XOFF might need to be enabled (serial printers). 
+ Your hardware (cable, port, printer) might be faulty. 


Job Corruption 
If jobs are printing in pieces, the printer might not have sufficient memory to hold the entire page 
to be printed. If it does not, it will print the part of the page it has in memory and continue printing 
on the next page. This problem occurs when printing jobs that contain large graphics. 

G5. Check status of the Printer in Novell iManager 
From Novell iManager, click iPrint > Manage Printer and then browse to and select the printer you 
want to check. 

G6. A problem is identified in an error message 


Try to determine problem from the status or error message and resolve it. 
+ Make sure that job input or output is not paused. 


+ Check for any details that are grayed out and not available; these might show you a problem. 


G7. Jobs are getting to the job list but the printer is unable to print them 


Do the following: 
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+ Make sure there are no holds or delays. 
+ Make sure the printer is configured properly. 


+ Check the status of the gateway if one is being used. 


See “Tracking Jobs from a Workstation” on page 119 for more information. 


Problems Integrating with Queue-Based Components 
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H1. Check the printer's spooling configuration 


Make sure the printer is configured to service the queue you are expecting the job to go to. See 
“Setting Print Job Spooling” on page 62 for more information. 


H2. Reconfigure spooling for this printer 


The spooling configuration specifies a different queue than the one you want this printer to service. 
See “Setting Print Job Spooling” on page 62 for information on how to configure job spooling. 
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H3. Check the job list for the queue 


Make sure the job is actually getting to the queue. 


H4. Make sure the job is being redirected to the queue properly 


Many applications are not designed for network printing. CAPTURE is a command line utility that 
configures print job redirection from applications not designed for NetWare print services. 
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Documentation Updates 


The ¡Print Administration Guide has been updated for the following dates: 
June 2004 - Support Pack 2 (page 127) 


June 2004 - Support Pack 2 


Changes were made to the following sections: 


Location Change 

“Using Printer Driver Profiles” on page 56 This section was added. 

“Using Printer Banner Pages” on page 57 This section was added. 

“Setting up Printer Configurations” This section was replaced by “Configuring Printer 


Settings” on page 59. 


“Using the ¡Print Printer List” on page 29 This section was modified because the ¡Print 
Client is no longer required to view the ¡Print 
Printer List. 


“Changing Printer Driver Default Install Options” This section was modified because this is no 
on page 41 longer included in the map tool. You can now use 
Printer Driver Profiles. 


“Modifying Printer Driver Defaults and Printer This section was modified and renamed to 
Persistence on a Map” “Modifying a Map's HTML Code” on page 39. 
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